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
apiKey | Required. Your personal API key. |
search | 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' — 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.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. |
Error codes
400 | Invalid parameters. |
401 | Access restricted. Enter the correct API key. |
402 | Access restricted. Check the credits balance. |
422 | Invalid MAC or OUI address was received. |
429 | Too many requests. Try your call again later. |
500 | Internal 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
apiKey | Required. Your personal API key. |
output | Optional. 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.
|