API Documentation

Making requests

GET https://mac-address.alldatafeeds.com/api/v1?apiKey=YOUR_API_KEY&output=json&search=44:38:39:ff:ef:57

Input parameters

apiKeyRequired. Your personal API key.
searchRequired. 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.
outputOptional. Output format:
  • 'json' — Full MAC address information in JSON format.
  • 'xml' — Full MAC address information in XML format.
  • 'csv' — Full MAC address information in CSV format.
  • 'vendor' (default) — Output vendor company name only, in text format.

Output format

JSON

{
    "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,
        "assignmentBlockSize":"MA-L",
        "dateCreated":"2012-04-08",
        "dateUpdated":"2015-09-27"
    },
    "macAddressDetails":{
        "searchTerm":"44:38:39:ff:ef:57",
        "isValid":true,
        "virtualMachine":"Not detected",
        "applications":[
            "Multi-Chassis Link Aggregation (Cumulus Linux)"
        ],
        "transmissionType":"unicast",
        "administrationType":"UAA",
        "wiresharkNotes":"No details",
        "comment":""
    }
}

XML

<Response>
    <vendorDetails>
        <oui>443839</oui>
        <isPrivate>false</isPrivate>
        <companyName>Cumulus Networks, Inc</companyName>
        <companyAddress>650 Castro Street, suite 120-245 Mountain View  CA  94041 US</companyAddress>
        <countryCode>US</countryCode>
    </vendorDetails>
    <blockDetails>
        <blockFound>true</blockFound>
        <borderLeft>443839000000</borderLeft>
        <borderRight>443839FFFFFF</borderRight>
        <blockSize>16777216</blockSize>
        <assignmentBlockSize>MA-L</assignmentBlockSize>
        <dateCreated>2012-04-08</dateCreated>
        <dateUpdated>2015-09-27</dateUpdated>
    </blockDetails>
    <macAddressDetails>
        <searchTerm>44:38:39:ff:ef:57</searchTerm>
        <isValid>true</isValid>
        <virtualMachine>Not detected</isValid>
        <applications>Multi-Chassis Link Aggregation (Cumulus Linux)</applications>
        <transmissionType>unicast</transmissionType>
        <administrationType>UAA</administrationType>
        <wiresharkNotes>No details</wiresharkNotes>
        <comment></comment>
    </macAddressDetails>
</Response>

CSV

oui,isPrivate,companyName,companyAddress,countryCode,blockFound,borderLeft,borderRight,blockSize,assignmentBlockSize,dateCreated,dateUpdated,searchTerm,isValid,virtualMachine,applications,transmissionType,administrationType,wiresharkNotes,comment
443839,0,"Cumulus Networks, Inc","650 Castro Street, suite 120-245 Mountain View  CA  94041 US",US,1,443839000000,443839FFFFFF,16777216,MA-L,2012-04-08,2015-09-27,44:38:39:ff:ef:57,1,Not detected,Multi-Chassis Link Aggregation (Cumulus Linux),unicast,UAA,No details,

Vendor only

Cisco Systems, Inc

Output parameters

vendorDetails.ouiOrganization Unique Identifier
vendorDetails.isPrivateFor 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.companyNameName of the company which registered the MAC addresses block.
vendorDetails.companyAddressCompany's full address.
vendorDetails.countryCodeCompany'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.borderLeftThe left border of the range the MAC address belongs to.
blockDetails.borderRightThe right border of the range the MAC address belongs to.
blockDetails.blockSizeThe total number of MAC addresses in this range.
blockDetails.assignmentBlockSizeAssignment 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.dateCreatedDate when the range was allocated, in YYYY-MM-DD format. Is available for ranges registered after 27 June, 2018.
blockDetails.dateUpdatedDate when the range was last updated, in YYYY-MM-DD format. Is available for ranges registered after 27 June, 2018.
macAddressDetails.searchTermEcho your search term
macAddressDetails.isValid'true' if the search term provided is a valid MAC address.
macAddressDetails.virtualMachineDetect 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.applicationsDetect if a vendor or standard is using the MAC address. It's an array field which may contain a list of applications detected.
macAddressDetails.transmissionTypeTransmission type, one of the following:
  • 'multicast'
  • 'unicast'
  • 'broadcast'
macAddressDetails.administrationTypeAdministration type, one of the following:
  • 'UAA' for Universally administered addresses
  • 'LAA' for Locally administered addresses
macAddressDetails.wiresharkNotesExtra details provided by Wireshark.
macAddressDetails.commentThe field which contains our research results regarding the MAC address or OUI.

Error codes

400Invalid parameters.
401Access restricted. Enter the correct API key.
402Access restricted. Check the credits balance.
422Invalid MAC or OUI address was received.
429Too many requests. Try your call again later.
500Internal server error. Try your call again or contact us.

Credits balance

GET https://mac-address.alldatafeeds.com/api/v1/credits?apiKey=YOUR_API_KEY

Input parameters

apiKeyRequired. Your personal API key.
outputOptional. Output format:
  • 'json' — Full MAC address information in JSON format.
  • 'xml' — Full MAC address information in XML format.
  • 'csv' — Full MAC address information in CSV format.
MAC address client library in Python languageMAC address client library in PHP languageNode.js MAC address client library

API Libraries

To make coding against MAC address API easier, use client libraries that reduce the amount of code you need to write.
MISP module for MAC Vendor Lookup APIYETI module for MAC Vendor Lookup APISplunk module for MAC Vendor Lookup API

API Integrations

We provide extensions for the major open source threat intelligence platforms. If you use any of them, you can easy integrate our service.
MAC address command-line utility

API Utilities

To make coding against MAC address API easier, use command-line utilities that reduce the amount of code you need to write.

Pricing plans for all team sizes

Our MAC Address API has a transparent pricing model suitable for business of any size. Please note that our service is for registered companies only. Requests from private individuals or emails that don't match the company domain name are ignored.

Billed MonthlyBilled Annually🎁 2 months FREE
MAC AddressBasic

$29 / month

Up to 1,000 API requests per day

MAC AddressProfessional

$99 / month

Up to 25,000 API requests per day

MAC AddressEnterprise

Ask for a quote

Custom API requests per day

You’ll be in good company

FlexWebAfricaWeWorkGuardDogCyberCNS

Contact Us

Got a technical issue? Want to send feedback about data feeds? Need details about our plans? Let us know. Please note that our service is for registered companies only. Requests from private individuals or emails that don't match the company domain name are ignored.