MACLookup API

https://maclookup.app/api-v2
Admin
MACLookup API is a free REST API service for looking up and retrieving vendor, company, and...
Tokens:3,324
Snippets:24
Trust Score:8.8
Update:3 weeks ago
Show doc for...
Tokens:
Raw
### Rate Limit Headers Example

Source: https://maclookup.app/api-v2/rate-limits

Example of rate limit headers returned by the MACLookup API V2. Shows the maximum requests allowed, remaining requests, and reset time in UTC epoch seconds.

```http
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 56
X-RateLimit-Reset: 1372700873
```

--------------------------------

### MAC Lookup API Success Response

Source: https://maclookup.app/api-v2/documentation

Example of a successful 200 OK response for a MAC address lookup.

```json
{
             "success": true,aaaaaaaaaa
             "found": true,
             "macPrefix": "000000",
             "company": "XEROX CORPORATION",
             "address": "M/S 105-50C, WEBSTER NY 14580, US",
             "country": "US",
             "blockStart": "000000000000",
             "blockEnd": "000000FFFFFF",
             "blockSize": 16777215,
             "blockType": "MA-L",
             "updated": "2015-11-17",
             "isRand": false,
             "isPrivate": false
           }
```

--------------------------------

### GET /v2/macs/{mac_address}

Source: https://maclookup.app/api-v2/documentation

Retrieves full information by MAC address. Accepts the entire MAC address or the first six characters. A prefix no registrant holds is not an error: the response is a 200 with found set to false and every other field empty.

```APIDOC
## GET /v2/macs/{mac_address}

### Description
Retrieve full information by MAC address. Accepts the entire MAC address or the first six characters. A prefix no registrant holds is not an error: the response is a 200 with `found` set to false and every other field empty.

### Method
GET

### Endpoint
https://api.maclookup.app/v2/macs/{mac_address}

### Parameters
#### Path Parameters
- **{mac_address}** (string) - Required - MAC address or MAC prefix, with at least 6 hexadecimal digits. Separators (":", "-", ".", " ") are optional and may be mixed, and input is case-insensitive. Valid MAC addresses are: 
  - 001A2B or 00:1A:2B or 00-1A-2B or 001A.2B
  - 001A2B3C4D5E or 00:1A:2B:3C:4D:5E or 00-1A-2B-3C-4D-5E or 001A.2B3C.4D5E or 00.1A.2B.3C.4D.5E
  Longer input is accepted; only the first 6 hexadecimal digits are matched.

#### Query Parameters
- **format** (string) - Optional - Output format. Default output is json. Valid values: json, jsonp, xml.
- **callback** (string) - Optional - function which should be executed when the request returns. If it's not set the default response is "_cb".
- **apiKey** (string) - Optional - Deprecated API keys are no longer issued. Existing keys remain valid until April 2027. More info.

### Response
#### Success Response (200)
- **success** (boolean) - If the request is valid status is "true".
- **found** (boolean) - When a MAC has a vendor, _found_ is **true**.
- **macPrefix** (string) - MAC prefix
- **company** (string) - Company Name
- **address** (string) - Company Address
- **blockStart** (string) - Start MAC range
- **blockEnd** (string) - End MAC range
- **blockSize** (number) - Number of possible unique MAC for this prefix
- **blockType** (string) - Assignment Type. MA-L: MAC Address Block Large (previously named OUI). Number of address 2^24 (~16 Million). MA-M: MAC Address Block Medium. Number of address 2^20 (~1 Million). MA-S: MAC Address Block Small (previously named OUI-36, encompasses IAB Assignments). Number of address 2^12 (4096). CID: Company Identifier. This prefix will not be used for globally unique applications. Number of address 2^24 (~16 Million).
- **updated** (string) - When MAC information was last updated. Format (YYYY-MM-DD)
- **isRand** (boolean) - This MAC can be transmitted when a device is not associated with an access point. In this case, it can be considered randomized.
- **isPrivate** (boolean) - The company prevents their name and address from showing up in the public listing.

#### Response Example (200)
```
{
  "success": true,
  "found": true,
  "macPrefix": "000000",
  "company": "XEROX CORPORATION",
  "address": "M/S 105-50C, WEBSTER NY 14580, US",
  "country": "US",
  "blockStart": "000000000000",
  "blockEnd": "000000FFFFFF",
  "blockSize": 16777215,
  "blockType": "MA-L",
  "updated": "2015-11-17",
  "isRand": false,
  "isPrivate": false
}
```

#### Error Response (400)
```
{
  "success": false,
  "error": "MAC must be greater than 5 chars",
  "errorCode": 101,
  "moreInfo": "https://maclookup.app/api-v2/documentation"
}
```

#### Error Response (401)
```
{
  "success": false,
  "error": "Unauthorized",
  "errorCode": 401,
  "moreInfo": "https://maclookup.app/api-v2/profiles"
}
```

#### Error Response (429)
```
{
  "success": false,
  "error": "Too Many Requests",
  "errorCode": 429,
  "moreInfo": "https://maclookup.app/api-v2/rate-limits"
}
```
```

--------------------------------

### MAC Lookup API 401 Unauthorized Response

Source: https://maclookup.app/api-v2/documentation

Example of a 401 Unauthorized response when the API key is invalid or missing.

```json
{
                "success": false,
              "error": "Unauthorized",
              "errorCode": 401,
              "moreInfo": "https://maclookup.app/api-v2/profiles"
           }
```

--------------------------------

### MAC Lookup API 400 Bad Request Response

Source: https://maclookup.app/api-v2/documentation

Example of a 400 Bad Request response when the provided MAC address is too short.

```json
{
                "success": false,
              "error": "MAC must be greater than 5 chars",
              "errorCode": 101,
              "moreInfo": "https://maclookup.app/api-v2/documentation"
           }
```

--------------------------------

### MAC Lookup API 429 Too Many Requests Response

Source: https://maclookup.app/api-v2/documentation

Example of a 429 Too Many Requests response when rate limits are exceeded.

```json
{
                "success": false,
              "error": "Too Many Requests",
              "errorCode": 429,
              "moreInfo": "https://maclookup.app/api-v2/rate-limits"
                }
```
Tokens:
Raw