50 lines
1.0 KiB
Markdown
50 lines
1.0 KiB
Markdown
|
# [MAC Address Lookup](https://macaddress.io/api)
|
||
|
|
||
|
## __Description__
|
||
|
Retrieve vendor details and other information regarding a given MAC address or an OUI
|
||
|
|
||
|
## __Example Request__
|
||
|
* Curl
|
||
|
```
|
||
|
curl "https://api.macaddress.io/v1?apiKey={{token}}&output=json&search=44:38:39:ff:ef:57"
|
||
|
```
|
||
|
|
||
|
* Raw
|
||
|
```
|
||
|
GET /v1?apiKey={{token}}&output=json&search=44:38:39:ff:ef:57 HTTP/1.1
|
||
|
Host: api.macaddress.io
|
||
|
```
|
||
|
|
||
|
## __Response__
|
||
|
* Success
|
||
|
```
|
||
|
{
|
||
|
"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,
|
||
|
...
|
||
|
```
|
||
|
* Error
|
||
|
```
|
||
|
{
|
||
|
"error":"Access restricted. Enter the correct API key."
|
||
|
}
|
||
|
```
|
||
|
## __Regex__
|
||
|
```
|
||
|
at_[a-zA-Z0-9]{29}
|
||
|
```
|
||
|
|
||
|
## __Example API key__
|
||
|
```
|
||
|
at_Fa2SfmKp3gkLD1PqoLfowkOts7pl3y
|
||
|
```
|