MAC Address Lookup



API Documentation V1


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

Available API Tool
  • Get Company info
  • Get Company name

Get Company 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 is not found, we will send a "404".
If it's not found, we'll send a "404".

GEThttps://api.maclookup.app/v1/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
Example:

https://api.maclookup.app/v1/macs/00:00:00:00:00:00


{
    mac: "000000",
    company: "XEROX CORPORATION",
    address: "M/S 105-50C, WEBSTER NY 14580, US",
    mac_start: "000000000000",
    mac_end: "000000FFFFFF",
    type: "MA-L",
    country: "US"
}
GEThttps://api.maclookup.app/v1/macs/{mac_address}?callback={callback_function}
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
{callback_function}function which should be executed when the request returns
Example:

https://api.maclookup.app/v1/macs/00:00:00:00:00:00?callback=myfunc


myfunc({
    mac: "000000",
    company: "XEROX CORPORATION",
    address: "M/S 105-50C, WEBSTER NY 14580, US",
    mac_start: "000000000000",
    mac_end: "000000FFFFFF",
    type: "MA-L",
    country: "US"
})
GEThttps://api.maclookup.app/v1/macs/{mac_address}?format=xml
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
{callback_function}function which should be executed when the request returns
Example:

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


<response>
        <mac>000000</mac>
        <company>XEROX CORPORATION</company>
        <address>M/S 105-50C, WEBSTER NY 14580, US</address>
        <mac_start>000000000000</mac_start>
        <mac_end>000000FFFFFF</mac_end>
        <type>MA-L</type>
        <country>US</country>
</response>

Response

FieldDescription
MACCompany prefix
companyCompany Name
addressCompany Address
mac_startStart MAC range
mac_endEnd MAC range
typeAssignment 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)

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, we will send a "404". If it's not found, we'll send a "404".

GEThttps://api.maclookup.app/v1/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
Example:

https://api.maclookup.app/v1/macs/00:00:00:00:00:00


XEROX CORPORATION