Our MAC Address Vendor/Manufacturer Lookup API allows you to query against our database and obtain information about any MAC address or OUI. Our simple to use RESTful API makes it easy to implement into any application you are building.
Costs and Query LimitsOur API is totally free! We pay for this site from our own pockets, ads, and donations. If you feel compelled (and you SHOULD!) to help us out, you can donate here :)
If you are querying too fast, in an inefficient or in an irresponsible way, we will initially throttle API requests coming from the specific IP address. If it continues, we will temporarily ban your IP block and any associated IP blocks registered through ARIN. If you are having any issues or no longer receiving a response from our API, please Contact Us so we can work out a custom solution to fit your needs... Especially if you happen to be an ISP in Evansville, IN ;)
How to use our APITo use our API, just send your requests to the following URL and you will receive a JSON encoded output.
https://www.macvendorlookup.com/api/v2/{MAC_Address}
Queries must be at least 6 hexadecimal characters long to be able to determine the manufacturer. However, some OUIs issued by IEEE are split into smaller chunks for companies that do not require a full OUI24 block. In that case, the first 6 characters of the MAC address will not be enough and you will need to supply 8 characters to query our OUI36 database. If at all possible, send the full MAC address in any format for the best possible result.
JSON OutputBy default, our API provides a JSON encoded response.
QueryResponse Output[{ "startHex":"0023AB000000", "endHex":"0023ABFFFFFF", "startDec":"153192759296", "endDec":"153209536511", "company":"CISCO SYSTEMS, INC.", "addressL1":"170 W. TASMAN DRIVE", "addressL2":"M\/S SJA-2", "addressL3":"SAN JOSE CA 95134-1706", "country":"UNITED STATES", "type":"oui24"}]The two relavent response headers provided are HTTP/1.1 200 OK and Content-Type: application/json
Value DescriptionsIn all of the reponse formats, the order of the values are the same. A description of each value is below.
startHexThe start of the MAC address range the vendor owns in hexadecimal formatendHexThe end of the MAC address range the vendor owns in hexadecimal formatstartDecThe start of the MAC address range the vendor owns in decimal formatendDecThe end of the MAC address range the vendor owns in decimal formatcompanyCompany name of the vendor or manufactureraddressL1First line of the address the company provided to IEEEaddressL2Second line of the address the company provided to IEEEaddressL3Third line of the address the company provided to IEEEcountryCountry the company is located intypeThere are 3 different major IEEE databases: MA-L, MA-M, and MA-SNo Match FoundIf there is no match in our database, you will receive an empty response with a status code of HTTP/1.1 204 No Content
Output FormatsIf you would like to specify a different output, append a /{OutputFormat} to the end of your query. Valid output formats are json, xml, csv, and pipe. The output from each type are below.
XML OutputQueryhttps://www.macvendorlookup.com/api/v2/0023AB7B5899/xml
Response0023AB0000000023ABFFFFFF153192759296153209536511CISCO SYSTEMS, INC.170 W. TASMAN DRIVEM/S SJA-2SAN JOSE CA 95134-1706UNITED STATESoui24The two relavent response headers provided are HTTP/1.1 200 OK and Content-Type: application/xml
Comma Delimited Format (CSV) OutputQueryhttps://www.macvendorlookup.com/api/v2/00:23:AB:7B:58:99/csv
Response"0023AB000000","0023ABFFFFFF","153192759296","153209536511","CISCO SYSTEMS, INC.","170 W. TASMAN DRIVE","M/S SJA-2","SAN JOSE CA 95134-1706","UNITED STATES","oui24"The two relavent response headers provided are HTTP/1.1 200 OK and Content-Type: text/csv
Pipe Character Seperated (|) OutputQueryhttps://www.macvendorlookup.com/api/v2/0023.ab7b.5899/pipe
Response0023AB000000|0023ABFFFFFF|153192759296|153209536511|CISCO SYSTEMS, INC.|170 W. TASMAN DRIVE|M/S SJA-2|SAN JOSE CA 95134-1706|UNITED STATES|oui24The two relavent response headers provided are HTTP/1.1 200 OK and Content-Type: text/plain
About REST (REpresentational State Transfer)We designed our API in a very RESTful way, so that your consumption of it is simple and straightforward. From聽Wikipedia:
REST's proponents argue that the Web's scalability and growth are a direct result of a few key design principles:
Application state and functionality are divided into resourcesEvery resource is uniquely addressable using a universal syntax for use in hypermedia linksAll resources share a uniform interface for the transfer of state between client and resource, consisting of
A constrained set of well-defined operationsA constrained set of content types, optionally supporting code on demandA protocol which is:
Client-serverStatelessCacheableLayeredREST's client/server separation of concerns simplifies component implementation, reduces the complexity of connector semantics, improves the effectiveness of performance tuning, and increases the scalability of pure server components. Layered system constraints allow intermediaries-proxies, gateways, and firewalls-to be introduced at various points in the communication without changing the interfaces between components, thus allowing them to assist in communication translation or improve performance via large-scale, shared caching.