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.

GET /mac/{mac}

MAC address API

One format. The vendor behind it.

One pooled request. Included on every plan.

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

Pass the address

Colons, dashes, dotted groups, or twelve hex digits.

Get a clean MAC

Uppercase, colon-separated, with a validity result.

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.

Measured response times and live API status

48 bits. Six octets.

Vendor lookup and normalization. One pooled request on every plan.

Start includes 1M API requests a month for $20/mo.

Get started Compare plans Read the docs

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"

// Example response · 200
{
  "mac": "00:23:DF:84:45:E6",
  "valid": true,
  "vendor": "Apple, Inc.",
  "local": false,
  "multicast": false
}

API reference SDKs Keys 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.

Get started Docs