MAC Address Lookup

API Documentation V2

This documentation is intended for developers who want to query MACLookup API.

Available API Endpoints

Get full info of a MAC
- Request
- Response
- Example
Get Company name by MAC

Request
Example

API Resources

Response code

Response code	Description
200 (OK)	Indicates that the client’s request was accepted successfully.
400 (Bad Request)	It is the generic client-side error status, used when no other 4xx error code is appropriate. Errors can be like malformed request syntax, invalid request message parameters, or deceptive request routing etc. The client SHOULD NOT repeat the request without modifications.
401 (Unauthorized)	Bad API Key.
429 (Too Many Requests)	The user has sent too many requests in a given amount of time. See Rate limits for more information

Get full info

Retrieve full information by MAC address.

To run a query, you must submit a request, specify a data format and some optional topics, and receive a formatted response in one of the following formats:

JSON
JSONP
XML

This endpoint accepts the entire MAC address or the first six characters. The MAC address may contain separators such as "-", ":" or ".".
If it's not found, we'll send a "404".

Request

GET	https://api.maclookup.app/v2/macs/{mac_address}

Field	Description
{mac_address}	MAC address or a substring (min 6 chars).Valid mac address are: - 00:00:00 or 00-00-00 or 00.00.00 or 000000 - 00:00:00:00:00:00 or 00-00-00-00-00-00 or 00.00.00.00.00.00

Query params	Description	Optional
format	Output format. Default output is json Valid values: json jsonp xml	Y
callback	function which should be executed when the request returns. If it's not set the default response is "_cb"	Y
apiKey	The API key is a unique identifier that is used to authenticate requests associated with your project for usage. API Key is not mandatory but it's recommended. Get an API Key	Y

Response

Query Params

Field	Description
success	If the request is valid status is true".
found	When a MAC has a vendor, found is true
mac	MAC prefix
company	Company Name
address	Company Address
blockStart	Start MAC range
blockEnd	End MAC range
blockSize	Number of possible unique MAC for this prefix
blockType	Assignment Type MA-L: MAC Address Block Large (previously named OUI). Number of address 2^24 (~16 Million) MA-M: MAC Address Block Medium. Number of address 2^20 (~1 Million) MA-S: MAC Address Block Small (previously named OUI-36, encompasses IAB Assignments). Number of address 2^12 (4096) CID: Company Identifier. This prefix will not be used for globally unique applications. Number of address 2^24 (~16 Million)
updated	MAC information last updated. Format (YYYY-MM-DD)
isRand	This MAC can be transmitted when a device is not associated with an access point. In this case, it can be considered randomized
isPrivate	The company prevents their name and address from showing up in the public listing

Example

Example:

GET	https://api.maclookup.app/v2/macs/00:00:00:00:00:00?apiKey=abcdefgh123456780

Code	Response
200	`{ "success": true, "found": true, "macPrefix": "000000", "company": "XEROX CORPORATION", "address": "M/S 105-50C, WEBSTER NY 14580, US", "country": "US", "blockStart": "000000000000", "blockEnd": "000000FFFFFF", "blockSize": 16777215, "blockType": "MA-L", "updated": "2015-11-17", "isRand": false, "isPrivate": false }`
400	`{ "success": false, "error": "MAC must be grater than 5 chars", "errorCode": 101, "moreInfo": "https://maclookup.app/api-v2/documentation" }`
401	`{ "success": false, "error": "Unauthorized", "errorCode": 401, "moreInfo": "https://maclookup.app/api-v2/plans" }`
429	`{ "success": false, "error": "Too Many Requests", "errorCode": 429, "moreInfo": "https://maclookup.app/api-v2/rate-limits" }`

Example:

GET	https://api.maclookup.app/v2/macs/00:00:00:00:00:00

Code Response

200

{
	"success": true,
	"found": true,
	"macPrefix": "000000",
	"company": "XEROX CORPORATION",
	"address": "M/S 105-50C, WEBSTER NY 14580, US",
	"country": "US",
	"blockStart": "000000000000",
	"blockEnd": "000000FFFFFF",
	"blockSize": 16777215,
	"blockType": "MA-L",
	"updated": "2015-11-17",
	"isRand": false,
	"isPrivate": false
}

400

{
	"success": false,
	"error": "MAC must be grater than 5 chars",
	"errorCode": 101,
	"moreInfo": "https://maclookup.app/api-v2/documentation"
}

429

{
	"success": false,
	"error": "Too Many Requests",
	"errorCode": 429,
	"moreInfo": "https://maclookup.app/api-v2/rate-limits"
}

Example:

GET	https://api.maclookup.app/v2/macs/00:00:00:00:00:00?format=jsonp&callback=foo

Code Response

200

Code	Response
200	`foo({ "success": true, "found": true, "macPrefix": "000000", "company": "XEROX CORPORATION", "address": "M/S 105-50C, WEBSTER NY 14580, US", "country": "US", "blockStart": "000000000000", "blockEnd": "000000FFFFFF", "blockSize": 16777215, "blockType": "MA-L", "updated": "2015-11-17", "isRand": false, "isPrivate": false });`
400	`foo({ "success": false, "error": "MAC must be grater than 5 chars", "errorCode": 101, "moreInfo": "https://maclookup.app/api-v2/documentation" });`
429	`foo({ "success": false, "error": "Too Many Requests", "errorCode": 429, "moreInfo": "https://maclookup.app/api-v2/rate-limits" });`

foo({
	"success": true,
	"found": true,
	"macPrefix": "000000",
	"company": "XEROX CORPORATION",
	"address": "M/S 105-50C, WEBSTER NY 14580, US",
	"country": "US",
	"blockStart": "000000000000",
	"blockEnd": "000000FFFFFF",
	"blockSize": 16777215,
	"blockType": "MA-L",
	"updated": "2015-11-17",
	"isRand": false,
	"isPrivate": false
});

400

foo({
	"success": false,
	"error": "MAC must be grater than 5 chars",
	"errorCode": 101,
	"moreInfo": "https://maclookup.app/api-v2/documentation"
});

429

foo({
	"success": false,
	"error": "Too Many Requests",
	"errorCode": 429,
	"moreInfo": "https://maclookup.app/api-v2/rate-limits"
});

Example:

GET	https://api.maclookup.app/v2/macs/00:00:00:00:00:00?format=xml

Code Response

200

Code	Response
200	`<response> <success>true</status> <found>true</found> <macPrefix>000000</macPrefix> <company>XEROX CORPORATION</company> <address>M/S 105-50C, WEBSTER NY 14580, US</address> <country>US</country> <blockStart>000000000000</blockStart> <blockEnd>000000FFFFFF</BlockEnd> <blockSize>16777215</blockSize> <blockType>MA-L</blockType> <updated>2015-11-17</updated> <isRand>false</isRand> <isPrivate>false</isPrivate> </response>`
400	`<response> <success>false</success> <error>MAC must be grater than 5 chars</error> <errorCode>101</errorCode> <moreInfo>https://maclookup.app/api-v2/documentation</moreInfo> </response>`
429	`<response> <success>false</success> <error>Too Many Requests</error> <errorCode>429</errorCode> <moreInfo>https://maclookup.app/api-v2/rate-limits</moreInfo> </response>`

<response>
    <success>true</status>
    <found>true</found>
    <macPrefix>000000</macPrefix>
    <company>XEROX CORPORATION</company>
    <address>M/S 105-50C, WEBSTER NY 14580, US</address>
    <country>US</country>
    <blockStart>000000000000</blockStart>
    <blockEnd>000000FFFFFF</BlockEnd>
    <blockSize>16777215</blockSize>
    <blockType>MA-L</blockType>
    <updated>2015-11-17</updated>
    <isRand>false</isRand>
    <isPrivate>false</isPrivate>
</response>

400

<response>
    <success>false</success>
    <error>MAC must be grater than 5 chars</error>
    <errorCode>101</errorCode>
    <moreInfo>https://maclookup.app/api-v2/documentation</moreInfo>
</response>

429

<response>
    <success>false</success>
    <error>Too Many Requests</error>
    <errorCode>429</errorCode>
    <moreInfo>https://maclookup.app/api-v2/rate-limits</moreInfo>
</response>

Get Company name

Retrieve company name by MAC address.

This endpoint accepts the entire MAC address or the first six characters. The MAC address may contain separators such as "-", ":" or ".". If it is not found, it returns "*NO COMPANY*.

Request

GET	https://api.maclookup.app/v2/macs/{mac_address}/company/name

Field	Description
{mac_address}	MAC address or a substring (min 6 chars).Valid mac address are: - 00:00:00 or 00-00-00 or 00.00.00 or 000000 - 00:00:00:00:00:00 or 00-00-00-00-00-00 or 00.00.00.00.00.00

Query params	Description	Optional
apiKey	The API key is a unique identifier that is used to authenticate requests associated with your project for usage. API Key is not mandatory but it's recommended. Get an API Key	Y

Example

GET	https://api.maclookup.app/v2/macs/00:00:00:00:00:00/company/name

Code	Response	Note
200	XEROX CORPORATION
200	PRIVATE	The company prevents their name and address from showing up in the public listing
200	NO COMPANY	The MAC does not belong to any company
400	MAC must be grater than 5 chars
401	Bad APIKey - Unauthorized - more info: https://maclookup.app/api-v2/plans
409	Too Many Requests - more info: https://maclookup.app/api-v2/rate-limits