Developer Reference

MAC Address Lookup API Documentation

MAC Address Lookup API Documentation: Identify network device manufacturers from MAC addresses (OUI lookup). Supports both EUI-48 and EUI-64 addresses in any common format. Returns vendor name, organization, address, country, and device type classification. Useful for network inventory, security auditing, and device identification.

MAC Address Lookup

Identify network device manufacturers from MAC addresses (OUI lookup). Supports both EUI-48 and EUI-64 addresses in any common format. Returns vendor name, organization, address, country, and device type classification. Useful for network inventory, security auditing, and device identification.

GET /v1/mac

Query Parameters

Parameter	Type	Description
mac required	string	MAC address in any format: `44:38:39:FF:EF:57` ((colon)) `44-38-39-FF-EF-57` ((dash)) `443839FFEF57` ((plain))

Response Fields

Field	Description
`mac`	Normalized MAC address
`type`	Address type (eui-48 or eui-64)
`oui`	Organizationally Unique Identifier (first 3 bytes)
`device_id`	Network Interface Controller ID (last 3 bytes)
`flags`	multicast, locally_administered, broadcast
`vendor.name`	Manufacturer/vendor name
`vendor.organization`	Full organization name
`vendor.country`	Country of registration
`vendor.device_type`	Device category (if known)

Use Cases

Network device inventory
Identify rogue devices on network
Asset management and auditing
IoT device classification

Example Request

curl "https://domscan.net/v1/mac?mac=44:38:39:ff:ef:57"

import requests

response = requests.get(
    "https://domscan.net/v1/mac",
    params={"mac": "44:38:39:ff:ef:57"}
)
data = response.json()

if data['vendor']['found']:
    print(f"Vendor: {data['vendor']['name']}")
    print(f"Country: {data['vendor']['country']}")
else:
    print("Unknown vendor (not in IEEE registry)")

Example Response

{
  "mac": "44:38:39:FF:EF:57",
  "input": "44:38:39:ff:ef:57",
  "type": "eui-48",
  "oui": "44:38:39",
  "device_id": "FF:EF:57",
  "flags": {
    "multicast": false,
    "locally_administered": false,
    "broadcast": false
  },
  "vendor": {
    "name": "Cumulus Networks, Inc",
    "found": true,
    "organization": "Cumulus Networks, Inc",
    "address": "650 Castro Street, Suite 120-245",
    "country": "US",
    "device_type": "networking",
    "source": "cache",
    "cached": true,
    "cache_age_s": 3600,
    "checked_at": "2025-01-15T12:00:00Z"
  },
  "meta": {
    "served_by": "pop=SJC country=US",
    "worker_version": "2.0.0",
    "latency_ms": 12
  }
}

GET /v1/mac/info

Response Fields

Field	Type
`endpoint`	string
`description`	string
`parameters`	object
`example_request`	string
`example_response`	object

Example Request

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/mac/info"

Example Response

{
  "endpoint": "/v1/mac",
  "description": "Lookup MAC address metadata and vendor information.",
  "parameters": {
    "mac": {
      "type": "string",
      "required": true,
      "description": "MAC address string in any common format",
      "example": "44:38:39:ff:ef:57"
    }
  },
  "example_request": "/v1/mac?mac=44:38:39:ff:ef:57",
  "example_response": {
    "mac": "44:38:39:FF:EF:57",
    "type": "eui-48",
    "oui": "44:38:39",
    "device_id": "FF:EF:57",
    "flags": {
      "multicast": false,
      "locally_administered": false,
      "broadcast": false
    },
    "vendor": {
      "name": "Cumulus Networks, Inc",
      "found": true,
      "source": "cache",
      "cached": true
    }
  }
}