all-about-apikey/mac-address-lookup/README.md

1.0 KiB

MAC Address Lookup

Description

Retrieve vendor details and other information regarding a given MAC address or an OUI

Example Request

  • Curl
curl "https://api.macaddress.io/v1?apiKey={{token}}&output=json&search=44:38:39:ff:ef:57"
  • Raw
GET /v1?apiKey={{token}}&output=json&search=44:38:39:ff:ef:57 HTTP/1.1
Host: api.macaddress.io

Response

  • Success
{
    "vendorDetails":{
        "oui":"443839",
        "isPrivate":false,
        "companyName":"Cumulus Networks, Inc",
        "companyAddress":"650 Castro Street, suite 120-245 Mountain View CA 94041 US",
        "countryCode":"US"},
        "blockDetails":{
            "blockFound":true,
            "borderLeft":"443839000000",
            "borderRight":"443839FFFFFF",
            "blockSize":16777216,
            ...
  • Error
{
    "error":"Access restricted. Enter the correct API key."
}

Regex

at_[a-zA-Z0-9]{29}

Example API key

at_Fa2SfmKp3gkLD1PqoLfowkOts7pl3y