MAmacadress

Look up a single MAC address

get/v1/mac/{mac}

Request

Path parameters

macstring required

Any common format: colon, dash, dot-grouped, space-separated, or bare hex (case-insensitive).

Response

Lookup result (present whether or not the address is registered)

macstring required

Canonical colon-separated uppercase form.

validboolean required
ouistring required

Always the first 24 bits of the address itself, regardless of matched block width. See matched_prefix for the complete matched registry block.

organizationstring nullable
vendor_addressstring nullable
countrystring nullable

ISO 3166-1 alpha-2

block_type'MA-L' | 'MA-M' | 'MA-S' | 'IAB' | 'CID' | 'null' nullable
address_capacityinteger nullable
range_startstring nullable
range_endstring nullable
registeredboolean required
transmission_type'unicast' | 'multicast' | 'broadcast' required
administration_type'universally_administered' | 'locally_administered' required
locally_administeredboolean required
slap_quadrant'AAI' | 'ELI' | 'reserved' | 'SAI' | 'null' nullable
eui64string nullable
ipv6_link_localstring nullable
potentially_randomizedboolean required
randomization_confidence'none' | 'possible' | 'likely' | 'unlikely' required
vendor_lookup_reliableboolean required
is_zeroboolean required
is_broadcastboolean required
explanationstring required
is_privateboolean required

Use organization === null and vendor_lookup_reliable instead.

matched_prefixstring nullable

The complete registered prefix actually matched, at its real width (colon-separated bytes plus a trailing bare hex nibble for a non-byte-aligned width like /28 or /36). Null when unregistered.

prefix_lengthinteger nullable

Changes

No recorded changes to this operation across all 1 revision of this API.