MAC Address Lookup

Find the vendor name of a device by entering an OUI or a MAC address

API Documentation V2

The MAC Lookup Rest API is available for free and provides a powerful tool for retrieving detailed information about any MAC address or OUI (Organizationally Unique Identifier).

With this API, you can seamlessly integrate MAC address and OUI lookup functionality into your applications, services, or systems.

Key features of our MAC Lookup Rest API include:

High Volume Support: Designed to handle a high volume of requests efficiently, our API is suitable for projects of any scale.
Low Latency: We prioritize low latency to ensure that you get fast responses to your queries, allowing your applications to perform at their best.
Rich Data: Our database contains extensive information about MAC addresses and OUIs, including vendor details, address types, and more.
User-Friendly: The API is easy to use and integrate into your applications, with comprehensive documentation and support available.

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 parameter	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 parameter

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	When MAC information was 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,aaaaaaaaaa "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 greater 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/profiles" }`
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

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 greater 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" }`

{
              "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 greater 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 greater 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 greater 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 greater 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 greater 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 parameter	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 greater than 5 chars
401	Bad APIKey - Unauthorized - more info: https://maclookup.app/api-v2/profiles
409	Too Many Requests - more info: https://maclookup.app/api-v2/rate-limits