Our database comes in the following forms: JSON, CSV, XML, Cisco vendorMacs.xml for maximum compatibility and fast integration into existing systems.
- Filename formats:
- macaddress.db.json
- macaddress.db.xml
- macaddress.db.csv
- macaddress.db.cisco.xml
Average file sizes
Filename | Gzipped file size |
---|
macaddress.db.json | 13.2MB |
macaddress.db.xml | 19.6MB |
macaddress.db.csv | 7.0MB |
macaddress.db.cisco.xml | 5.8MB |
Output format
JSON output format
{
"oui":"08:EC:F5",
"isPrivate":false,
"companyName":"Cisco Systems, Inc",
"companyAddress":"80 West Tasman Drive San Jose CA 94568",
"countryCode":"US",
"assignmentBlockSize":"MA-L",
"dateCreated":"2018-11-09",
"dateUpdated":"2018-11-09"
}
XML output format
<record>
<oui>08:EC:F5</oui>
<isPrivate>0</isPrivate>
<companyName>Cisco Systems, Inc</companyName>
<companyAddress>80 West Tasman Drive San Jose CA 94568</companyAddress>
<countryCode>US</countryCode>
<assignmentBlockSize>MA-L</assignmentBlockSize>
<dateCreated>2018-11-09</dateCreated>
<dateUpdated>2018-11-09</dateUpdated>
</record>
CSV output format
oui,isPrivate,companyName,companyAddress,countryCode,assignmentBlockSize,dateCreated,dateUpdated
08:EC:F5,0,"Cisco Systems, Inc","80 West Tasman Drive San Jose CA 94568",US,MA-L,2018-11-09,2018-11-09
Cisco vendorMacs.xml format
<MacAddressVendorMappings xmlns="http://www.cisco.com/server/spt">
<VendorMapping mac_prefix="08:EC:F5" vendor_name="Cisco Systems, Inc"></VendorMapping>
</MacAddressVendorMappings>
Output parameters
oui | Organization Unique Identifier |
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'. |
companyName | Name of the company which registered the MAC addresses block. |
companyAddress | Company's full address. |
countryCode | Company's country code in ISO 3166 format. |
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
|
dateCreated | Date when the range was allocated, in YYYY-MM-DD format. Is available for ranges registered after 27 June, 2018. |
dateUpdated | Date when the range was last updated, in YYYY-MM-DD format. Is available for ranges registered after 27 June, 2018. |