MAC address API

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

We deliver full & up-to-date data provided
directly from the IEEE Standards Association.

Average response 50 ms
You are allowed up to 500 requests per second

Making requests

It takes up to a minute to activate your account after the registration.

Input parameters


Required. Your personal API key. To obtain one, please sign up.


Required. Search term: MAC address or OUI. You can use any octet delimiters including ':', '.', or even no delimiter. At least 6 BASE16 chars should be provided.

output Optional. Output format:
  • 'json' (default) — Full MAC address information in JSON format.
  • 'xml' — Full MAC address information in XML format.
  • 'csv' — Full MAC address information in CSV format.
  • 'vendor' — Output vendor company name only, in text format.

Output format

    "vendorDetails": {
        "oui": "34F8E7",
        "isPrivate": false,
        "companyName": "Cisco Systems, Inc",
        "companyAddress": "80 West Tasman Drive San Jose  CA  94568 US",
        "countryCode": "US"
    "blockDetails": {
        "blockFound": true,
        "borderLeft": "34F8E70000000000",
        "borderRight": "34F8E7FFFFFFFFFF",
        "blockSize": 1099511627776,
        "assignmentBlockSize": "MA-L",
        "dateCreated": "2018-08-22",
        "dateUpdated": "2018-08-22"
    "macAddressDetails": {
        "searchTerm": "34:F8:E7",
        "isValid": false,
        "transmissionType": "multicast",
        "administrationType": "LAA"

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.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


from maclookup import ApiClient
import logging

client = ApiClient('Your API key')

logging.basicConfig(filename='myapp.log', level=logging.WARNING)

print(client.get_raw_data('00A043AAAAAA', 'json'))

response = client.get('00A043AAAAAA')


You're just one step away from getting a free
and fully functional access!

Get 1000 daily requests for free

No credit card or company information needed.

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 or just fill in the contact form.

The data was just refreshed