Output format | Documentation | MAC Address API | WhoisXML API

Output format

{
    "vendorDetails": {
        "oui": "00005E",
        "isPrivate": false,
        "companyName": "Icann, Iana Department",
        "companyAddress": "INTERNET ASS'NED NOS.AUTHORITY Los Angeles CA 90094-2536 US",
        "countryCode": "US"
    },
    "blockDetails": {
        "blockFound": true,
        "borderLeft": "00005E000000",
        "borderRight": "00005EFFFFFF",
        "blockSize": 16777216,
        "assignmentBlockSize": "MA-L",
        "dateCreated": "1980-01-01",
        "dateUpdated": "2015-09-27"
    },
    "macAddressDetails": {
        "searchTerm": "00:00:5e:00:53:af",
        "isValid": true,
        "virtualMachine": "Microsoft Virtual PC / Virtual Server",
        "applications": [
            "Assigned for use in documentation"
        ],
        "transmissionType": "unicast",
        "administrationType": "UAA",
        "wiresharkNotes": "No details",
        "comment": ""
    }
}

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.applications
Detect if a vendor or standard is using the MAC address. It's an array field which may contain a list of applications detected.
macAddressDetails.transmissionType
Transmission type, one of the following: multicast, unicast, broadcast.
macAddressDetails.administrationType

Administration type, one of the following:

  • UAA for Universally administered addresses
  • LAA for Locally administered addresses
macAddressDetails.wiresharkNotes
Extra details provided by Wireshark.
macAddressDetails.comment
The field which contains our research results regarding the MAC address or OUI.