Endpoint
GET https://macvendorcheck.com/api/mac/{mac}
The MAC can be full or just the OUI, with or without separators: 28:6F:B9:12:34:56, 28-6F-B9 or 286FB9 all work.
Example
curl https://macvendorcheck.com/api/mac/286FB9
{
"success": true,
"mac": "28:6F:B9",
"oui": "286FB9",
"vendor": "Nokia Shanghai Bell Co., Ltd.",
"registry": "MA-L",
"country": "CN",
"page": "https://macvendorcheck.com/mac/286FB9"
}
Notes
- Rate limit: 100 requests a day and 30 a minute, per IP.
- None required for the free per-IP allowance. An IPNOVA API key (free account at api.ipnova.com) applies your plan allowance instead: send it as the X-Api-Key header or the ?key= query parameter. Keyed responses carry X-Credits-Remaining and X-Credits-Used.
- An unknown or unregistered prefix now returns HTTP 404 with the shared error envelope, for example
{"success":false,"error":true,"reason":"not_found","message":"No vendor found for this MAC in the IEEE registry.","docs":"https://macvendorcheck.com/mac-address-lookup-api","mac":"02:00:00"}, with the normalized MAC echoed back. - Data is the official IEEE MA-L, MA-M and MA-S registry, refreshed monthly.
- Machine-readable spec at
/openapi.json. - Please keep the attribution link if you display results publicly.
Errors
Every non-200 response uses the same envelope: success: false, an error flag, a machine-readable reason, a human message, and a docs link back to this page.
| Status | Reason | Meaning |
|---|---|---|
400 | invalid_input | Not a valid MAC or OUI shape |
401 | invalid_key | The supplied API key is unknown or revoked |
404 | not_found | Unknown or unregistered prefix |
429 | rate_limit | Too many requests in the last minute (Retry-After: 60) |
429 | daily_limit | Keyless per-IP daily cap reached |
429 | credits_exhausted | Keyed monthly allowance used up |