This API will find a MAC address vendor for the MAC address provided. IEEE is the registration authority for MAC addresses to registered vendors.
Access to the API:
MAC Lookup is available for FREE, but you're required to supply a key. A valid key can be requested on your profile page.
API Endpoint:
https://api.iplocation.net/?cmd=mac-lookup&key={HASH KEY}&m=AA-BB-CC-DD-EE-FF
Request parameters:
| Name |
Required |
Description |
Default |
| key |
yes |
A free key can be obtained by requesting one. |
- |
| format |
no |
Output format, the following formats are supported: plain xml json jsonp php csv serialized |
json |
| delimiter |
no |
Delimiter between proxies. Can be used only with format plain. The following types are supported: 1 for "\n", 2 for "<br>". |
1 |
| mac address |
yes |
A MAC address (either separated by : or dash). |
- |
Response Parameters:
| Name |
Description |
| mac |
A MAC address to be lookup for a vendor. |
| vendor |
Vendor of the MAC address |
| company |
A full company name of the MAC address |
| result |
The indication of whether the vendor for the MAC address was found (1=Yes, 0=No). |
| response_code |
Response status code to indicate success or failed completion of the API call. |
| response_message |
Response message to indicate success or failed completion of the API call. |
Response Codes & Messages:
| Name |
Message |
Description |
| 200 |
OK |
Successfully processed the request. |
| 400 |
Bad Request |
Failed to complete the request. |
| 404 |
Not Found |
Command not found. |
Example API Call
Example Request:
https://api.iplocation.net/?cmd=mac-lookup&key=XXXXX&m=F8-B1-56-B8-5F-55
Example Response:
{"mac":"AA-BB-CC-DD-EE-FF","vendor":"Dell","company":"Dell, Inc","start":"AABBCC0000","end":"AABBCCFFFF","result":"1","response_code":"200","response_message":"OK"}
