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

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,
             "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
{
              "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
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
<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