MAC Vendors REST API

API Endpoint

The public web UI is served separately from the REST API. Under the Apache proxy configuration, API requests are available below /api/.

Use the following URL to perform a MAC address lookup via the API:

https://macvendors.co.uk/api/mac_lookup/<mac_address>

Replace <mac_address> with the MAC address you want to query. For example:

https://macvendors.co.uk/api/mac_lookup/00:1A:2B:3C:4D:5E

Response Format

The API will return a JSON response:

{
    "mac_address": "00:1A:2B:3C:4D:5E",
    "vendor": "Cisco Systems, Inc"
}
            

HTTP Status Codes

• 200 OK: Request was successful, and the vendor was found.
• 404 Not Found: Vendor not found for the given MAC address.
• 400 Bad Request: Invalid MAC address format.

Accepted MAC Address Formats

• Colon-separated: 00:00:0A:BB:28:FC
• Dash-separated: 00-00-0A-BB-28-FC
• Dot-separated (Cisco): 0000.0ABB.28FC
• Space-separated: 00 00 0A BB 28 FC
• Unformatted: 00000ABB28FC

Rate Limiting

For fair usage, API requests are rate-limited. If you exceed the limit, you may receive a 429 Too Many Requests error.

When to Use the API

Use the API for scripts, monitoring systems, inventory tooling, and network automation where a browser lookup is not practical. For pasted switch or ARP output, the bulk lookup page is usually faster.