MAClens

MAC address analysis

fren

API documentation

The MAClens API returns a JSON analysis of a MAC address: normalized formats, I/G and U/L bits, manufacturer from the IEEE MA-L, MA-M and MA-S registries, and documented special cases.

Endpoints

Two identical paths are exposed:

  • GET /api/public/mac/:mac

    Accessible from any site or script (CORS enabled). Use this for external calls.

  • GET /api/mac/:mac

    Same response, exposed internally for the app.

Parameters

?lang=lang
fr or en (default: en)
:mac
The MAC address, with or without separators (:, -, .) or as continuous hex.

Response structure

  • address — canonical, hex, dashed, Cisco and EUI-64 formats.
  • bits — I/G (transmission), U/L (administration: universal or local).
  • vendor — name, prefix, IEEE registry kind, country and flag.
  • special — title, summary and usage for reserved addresses.

Errors

  • 400 missing_mac — no address provided.
  • 422 invalid_mac — unrecognised format.

Example

Replace :mac with the address to analyse.

curl -s "https://project--0360dcfd-446d-42de-96da-f4b4aaa8224a.lovable.app/api/public/mac/28:6F:B9:12:34:56?lang=en"

curl example

Also read