Output format | Documentation | API | MAC Address Vendor Lookup

Output format

{
    "vendorDetails":{
        "oui":"08ECF5",
        "isPrivate":false,
        "companyName":"Cisco Systems, Inc",
        "companyAddress":"80 West Tasman Drive San Jose  CA  94568 US",
        "countryCode":"US"
    },
    "blockDetails":{
        "blockFound":true,
        "borderLeft":"08ECF5000000",
        "borderRight":"08ECF5FFFFFF",
        "blockSize":16777216,
        "assignmentBlockSize":"MA-L",
        "dateCreated":"2018-11-09",
        "dateUpdated":"2018-11-09"
    },
    "macAddressDetails":{
        "searchTerm":"08:ec:f5:36:1f:57",
        "isValid":true,
        "virtualMachine": "Not detected",
        "transmissionType":"unicast",
        "administrationType":"UAA"
    }
}

Output parameters

vendorDetails.oui Organization Unique Identifier
vendorDetails.isPrivate For an extra fee to IEEE, vendors can hide their details. In this case, this flag is set to 'true' and companyName, companyAddress and countryCode are 'private'.
vendorDetails.companyName Name of the company which registered the MAC addresses block.
vendorDetails.companyAddress Company's full address.
vendorDetails.countryCode Company's country code in ISO 3166 format.
blockDetails.blockFound 'false' when the MAC address does not belong to any of the registered MAC blocks. In this case, all other fields are set to 'unknown'
blockDetails.borderLeft The left border of the range the MAC address belongs to.
blockDetails.borderRight The right border of the range the MAC address belongs to.
blockDetails.blockSize The total number of MAC addresses in this range.
blockDetails.assignmentBlockSize Assignment block size, one of the following:
  • 'MA-L' for MAC Address Block Large
  • 'MA-M' for MAC Address Block Medium
  • 'MA-S' for MAC Address Block Small
  • 'IAB' for Individual Address Block
blockDetails.dateCreated Date when the range was allocated, in YYYY-MM-DD format. Is available for ranges registered after 27 June, 2018.
blockDetails.dateUpdated Date when the range was last updated, in YYYY-MM-DD format. Is available for ranges registered after 27 June, 2018.
macAddressDetails.searchTerm Echo your search term
macAddressDetails.isValid 'true' if the search term provided is a valid MAC address.
macAddressDetails.virtualMachine Detect if the MAC address belongs to a Virtual Machine. It’s a string field which could be 'Not detected' or the name of the virtual machine detected, like 'VMWare'.
macAddressDetails.transmissionType Transmission type, one of the following:
  • 'multicast'
  • 'unicast'
macAddressDetails.administrationType Administration type, one of the following:
  • 'UAA' for Universally administered addresses
  • 'LAA' for Locally administered addresses

Have questions?

We work hard to improve our services for you. As part of that process we welcome your feedback, questions and suggestions. Please let us know your thoughts and feelings, and any way in which you think we can improve our product.

Shoot us an email to support@macaddress.io or just fill in the contact form.

The data was just refreshed