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

Response code

Response codeDescription
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

GEThttps://api.maclookup.app/v2/macs/{mac_address}
FieldDescription
{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 paramsDescriptionOptional
formatOutput format.
Default output is json
Valid values:
  • json
  • jsonp
  • xml
Y
callbackfunction which should be executed when the request returns.
If it's not set the default response is "_cb"
Y
apiKeyThe 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

FieldDescription
successIf the request is valid status is true".
foundWhen a MAC has a vendor, found is true
macMAC prefix
companyCompany Name
addressCompany Address
blockStartStart MAC range
blockEndEnd MAC range
blockSizeNumber of possible unique MAC for this prefix
blockTypeAssignment 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)
updatedMAC information last updated. Format (YYYY-MM-DD)
isRandThis MAC can be transmitted when a device is not associated with an access point. In this case, it can be considered randomized
isPrivateThe company prevents their name and address from showing up in the public listing

Example

Example:
GEThttps://api.maclookup.app/v2/macs/00:00:00:00:00:00?apiKey=abcdefgh123456780
CodeResponse
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:
GEThttps://api.maclookup.app/v2/macs/00:00:00:00:00:00
CodeResponse
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:
GEThttps://api.maclookup.app/v2/macs/00:00:00:00:00:00?format=jsonp&callback=foo
CodeResponse
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"
});
Example:
GEThttps://api.maclookup.app/v2/macs/00:00:00:00:00:00?format=xml
CodeResponse
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>

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

GEThttps://api.maclookup.app/v2/macs/{mac_address}/company/name
FieldDescription
{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 paramsDescriptionOptional
apiKeyThe 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

GEThttps://api.maclookup.app/v2/macs/00:00:00:00:00:00/company/name
CodeResponseNote
200XEROX 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
400MAC must be grater than 5 chars
401Bad APIKey - Unauthorized - more info: https://maclookup.app/api-v2/plans
409Too Many Requests - more info: https://maclookup.app/api-v2/rate-limits