GET /mac/{mac}
MAC address API
One format. The vendor behind it.
Try it
{
"mac": "00:23:DF:84:45:E6",
"valid": true,
"vendor": "Apple, Inc.",
"local": false,
"multicast": false
}1M requests · $20/mo. Get started
What comes back.
mac
48-bit address in uppercase colon notation. Invalid input echoes the original value with surrounding whitespace removed
valid
The input is a supported 48-bit MAC address. This does not prove a device exists
vendor
Registered assignment holder. Null for unknown prefixes, locally administered addresses, and multicast addresses. This does not identify a device model or owner
local
The locally administered bit is set. Null for invalid input. This flag alone does not prove randomization
multicast
The group address bit is set. Null for invalid input
1
Pass the address
Colons, dashes, dotted groups, or twelve hex digits.
2
Get a clean MAC
Uppercase, colon-separated, with a validity result.
3
Identify the assignment
The registered vendor, plus local and multicast flags.
Coverage
48-bit MAC addresses. Registered assignment holders for known global unicast prefixes.
Give network inventories one address format. Colons, dashes, dots, or bare hex come back as an uppercase MAC address, with the registered vendor and local and multicast flags.
Each lookup counts as one pooled request on your plan. The vendor is the registered assignment holder for the address prefix.
SPEED
How long /mac takes.
Median time to first byte over the last seven days. Warm requests, measured every 30 minutes. Live verification and other request variants can take longer.
US
19ms
EU
19ms
APAC
38ms
LatAm
48ms
ME
88ms
Make your first request.
One key works across the APIs. Copy a request in your language and get JSON back.
curl "https://api.parseapi.com/mac/00:23:DF:84:45:E6" \
-H "X-API-Key: YOUR_API_KEY" \
-H "Parse-Version: 2.0.0"// Example response · 200{"mac": "00:23:DF:84:45:E6", "valid": true, "vendor": "Apple, Inc.", "local": false, "multicast": false }
API referenceSDKsKeys and authentication
Every response field
Response fields
- mac
- 48-bit address in uppercase colon notation. Invalid input echoes the original value with surrounding whitespace removed
- valid
- The input is a supported 48-bit MAC address. This does not prove a device exists
- vendor
- Registered assignment holder. Null for unknown prefixes, locally administered addresses, and multicast addresses. This does not identify a device model or owner
- local
- The locally administered bit is set. Null for invalid input. This flag alone does not prove randomization
- multicast
- The group address bit is set. Null for invalid input
QUESTIONS
- Which MAC address formats work?
- Six two-digit octets separated by colons or dashes, three four-digit dotted groups, or twelve bare hexadecimal digits. Mixed case is accepted. The response uses uppercase colon notation. Pass a full 48-bit address, not a prefix or an EUI-64 address.
- Does vendor identify the device?
- vendor names the registered assignment holder for the address prefix. It does not identify the device model, its owner, or whether the address was copied onto another interface.
- What does local mean?
- local is true when the locally administered bit is set. This alone does not prove the address was randomized. Local and multicast addresses return vendor: null.
- What if the address or vendor is unknown?
- A valid address with an unknown assignment returns vendor: null. Invalid input returns 200 with valid: false and null vendor, local, and multicast fields.
- What does a MAC lookup cost?
- One pooled request on every plan, including vendor lookup. There is no separate lookup charge. deep=true adds an empty deep object.
Know the vendor.
MAC address validation and registered vendor lookup. Every plan.
Start includes 1M API requests a month for $20/mo.