all-about-apikey/mac-address-lookup/README.md

50 lines
1.0 KiB
Markdown
Raw Permalink Normal View History

2022-06-17 23:47:02 +00:00
# [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
```