MAC Address Generator API

Generate random MAC addresses (locally administered unicast by default, optional vendor OUI prefix), or inspect and reformat an existing one.

Generate random MAC addresses in bulk, with an optional fixed OUI, or normalise pasted MACs to colon, hyphen or Cisco dot format and check their U/L and I/G bits.

Input

Send these as a JSON object. Unknown fields are rejected.

mode

generate: random addresses. inspect: reformat and describe the address in input. (string, one of generate, inspect, default "generate")

count

How many to generate (1 to 1000). (integer, 1 to 1000, default 1)

format

colon (aa:bb:cc:dd:ee:ff), hyphen (aa-bb-…), dot (aabb.ccdd.eeff, Cisco) or none. (string, one of colon, hyphen, dot, none, default "colon")

uppercase

Uppercase hex digits. (boolean, default false)

local

Generate: set the locally administered bit (safe for VMs and testing). (boolean, default true)

multicast

Generate: set the multicast (group) bit. (boolean, default false)

oui

Generate: fixed 3-byte vendor prefix, e.g. 00:1A:2B. Its bits are kept as written. (string, up to 20 characters, default "")

input

Inspect: the MAC address to describe, in any common format. (string, up to 40 characters)