API URL
GET /api/v1/mac-address
Headers
Code
Content-Type: application/jsonQuery Parameters
Param
Type
Description
mac
required
string
Full MAC address for vendor lookup
prefix
required
string
Full MAC prefix (e.g. 00:1A:2B), exact match. Will be uppercased.
org
required
string
Organization name substring. Case-insensitive. At least one of prefix/org must be provided.
Example GET Request
Code
GET /api/v1/mac-address?prefix=00:1A:2BSuccessful Response
Status
HTML
200 OKBody
Code
[
{
"prefix": "00:1A:2B",
"organization": "Cisco Systems",
"registry": "MA-L"
}
]Field
Type
success
boolean
count
integer
mac_address
string
vendor
string
data
array
data[].prefix
string
data[].organization
string
data[].address
string
correlationId
string
Error Response
Example
Code
400 MISSING_QUERY – If neither prefix nor org is provided
404 NOT_FOUND – No matching result found
500 SERVER_ERROR – Unexpected database or query issueLast Updated: May 4, 2026