MAC Address Lookup
Find the vendor name of a device by entering an OUI or a MAC address
API Documentation V2
This documentation is intended for developers who want to query MACLookup API.
Available API Endpoints
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:
|
Query parameter | Description | Optional |
format | Output format. Default output is json Valid values:
| 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
|
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 |
|
400 |
|
401 |
|
429 |
|
Example:
GET | https://api.maclookup.app/v2/macs/00:00:00:00:00:00 |
Code | Response |
---|---|
200 |
|
400 |
|
429 |
|
Example:
GET | https://api.maclookup.app/v2/macs/00:00:00:00:00:00?format=jsonp&callback=foo |
Code | Response |
---|---|
200 |
|
400 |
|
429 |
|
Example:
GET | https://api.maclookup.app/v2/macs/00:00:00:00:00:00?format=xml |
Code | Response |
---|---|
200 |
|
400 |
|
429 |
|
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:
|
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 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 |