{"openapi":"3.1.0","info":{"title":"MAC Address API","version":"1.0.0","description":"Validate, reformat and analyse MAC (EUI-48) addresses — entirely locally. The format endpoint accepts a MAC in any common notation — colon (aa:bb:cc:dd:ee:ff), hyphen (aa-bb-…), Cisco dotted (aabb.ccdd.eeff) or bare (aabbccddeeff) — and returns it in the notation you ask for plus all the others, in upper or lower case, normalising messy input into a clean canonical form. The info endpoint analyses an address: it splits the OUI (the manufacturer prefix) from the NIC portion, reports whether the address is unicast or multicast (the I/G bit) and whether it is universally or locally administered (the U/L bit), flags the broadcast address, and derives the Modified EUI-64 interface identifier and the matching IPv6 link-local address (fe80::…) per RFC 4291. Everything is computed locally and deterministically, so it is instant and private — no lookups, no third-party calls. Ideal for network automation and IPAM, switch/router and firewall tooling, device inventory and asset management, DHCP and provisioning, and IPv6 SLAAC work. Pure local computation — no key, no third-party service, instant. Live, nothing stored. 3 endpoints. This formats and analyses the address; to look up the manufacturer behind a MAC use a MAC-vendor API.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/macaddr-api","description":"oanor gateway"}],"tags":[{"name":"MAC"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/format":{"get":{"operationId":"get_v1_format","tags":["MAC"],"summary":"Reformat a MAC address","description":"","parameters":[{"name":"mac","in":"query","required":true,"description":"A MAC address in any notation","schema":{"type":"string"},"example":"00:1a:2b:3c:4d:5e"},{"name":"format","in":"query","required":false,"description":"colon (default), hyphen, dot (cisco), or bare","schema":{"type":"string"},"example":"colon"},{"name":"case","in":"query","required":false,"description":"lower (default) or upper","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"mac":"00:1a:2b:3c:4d:5e","case":"lower","format":"colon","formats":{"dot":"001a.2b3c.4d5e","bare":"001a2b3c4d5e","colon":"00:1a:2b:3c:4d:5e","hyphen":"00-1a-2b-3c-4d-5e"}},"meta":{"timestamp":"2026-06-03T09:25:01.273Z","request_id":"450ad1db-60a1-45ad-ab3a-ae692a382d40"},"status":"ok","message":"Reformat a MAC address","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/info":{"get":{"operationId":"get_v1_info","tags":["MAC"],"summary":"Analyse a MAC address","description":"","parameters":[{"name":"mac","in":"query","required":true,"description":"A MAC address","schema":{"type":"string"},"example":"00:1a:2b:3c:4d:5e"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"mac":"00:1a:2b:3c:4d:5e","nic":"3c:4d:5e","oui":"00:1a:2b","cast":"unicast","eui64":"02:1a:2b:ff:fe:3c:4d:5e","valid":true,"broadcast":false,"multicast":false,"administration":"universally administered (OUI)","link_local_ipv6":"fe80::021a:2bff:fe3c:4d5e","locally_administered":false},"meta":{"timestamp":"2026-06-03T09:25:01.379Z","request_id":"72d52daa-194b-4c1f-8b96-b2ef7f37feff"},"status":"ok","message":"Analyse a MAC address","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"name":"MAC Address API","notes":"Accepts aa:bb:cc:dd:ee:ff, aa-bb-…, aabb.ccdd.eeff or aabbccddeeff. EUI-64 flips the U/L bit and inserts FF-FE, per RFC 4291. This formats and analyses the address — to look up the manufacturer behind a MAC use a MAC-vendor API. Nothing is stored.","version":"v1","endpoints":[{"path":"/v1/format","params":{"mac":"a MAC address in any notation (required)","case":"lower (default) or upper","format":"colon (default), hyphen, dot (cisco), or bare"},"returns":"the MAC in the chosen notation and all common formats"},{"path":"/v1/info","params":{"mac":"a MAC address (required)"},"returns":"OUI/NIC, unicast/multicast, U/L scope, EUI-64 and link-local IPv6"},{"path":"/v1/meta","params":[],"returns":"this document"}],"description":"Validate, reformat and analyse MAC (EUI-48) addresses. The format endpoint accepts a MAC in any common notation — colon, hyphen, Cisco dotted or bare — and returns it in the notation you want plus all the others, in upper or lower case. The info endpoint analyses an address: its OUI (manufacturer prefix) and NIC parts, whether it is unicast or multicast (the I/G bit) and universally or locally administered (the U/L bit), whether it is the broadcast address, and the derived Modified EUI-64 interface identifier and the matching IPv6 link-local address (fe80::…). Pure local, no key."},"meta":{"timestamp":"2026-06-03T09:25:01.478Z","request_id":"50c56641-7609-4db4-a2d8-c5edba13fb24"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":3235,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":475,"monthly_call_quota":12750,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2465,"monthly_call_quota":178500,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":6265,"monthly_call_quota":935000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/macaddr-api"}