# MAC Vendor API
> Identify the manufacturer behind any MAC address. Look up a MAC or OUI to get the assigned vendor, its short name and the exact assignment block (/24, /28 or /36) using the official IEEE registry, search the registry by vendor name to find all of a company’s OUIs, or generate random valid test MAC addresses for a given vendor. MAC addresses are accepted in every common format — colon, hyphen, dot or bare hex — and bare OUIs work too. Built on the open IEEE OUI dataset (~57,000 assignments) and served entirely in-memory, so responses are instant and the service is always available. Ideal for network scanning and monitoring, IoT and device identification, security and asset inventory, NAC and devops tooling.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/macvendor-api/..."
```

## Pricing
- **Free** (Free) — 30,000 calls/Mo, 2 req/s
- **Basic** ($5/Mo) — 500,000 calls/Mo, 10 req/s
- **Pro** ($16/Mo) — 3,000,000 calls/Mo, 25 req/s
- **Mega** ($42/Mo) — 30,000,000 calls/Mo, 100 req/s

## Endpoints

### MAC

#### `GET /v1/generate` — Generate test MAC(s) for a vendor

**Parameters:**
- `vendor` (query, optional, string) — Vendor name Example: `Cisco`
- `oui` (query, optional, string) — OUI (alternative to vendor)
- `count` (query, optional, string) — 1-50 (default 1) Example: `2`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/macvendor-api/v1/generate?vendor=Cisco&count=2"
```

**Response:**
```json
{
    "data": {
        "oui": "10:57:25",
        "macs": [
            "10:57:25:FF:42:4D",
            "10:57:25:D9:C8:7A"
        ],
        "count": 2,
        "vendor": "Cisco Systems, Inc",
        "vendor_short": "Cisco"
    },
    "meta": {
        "timestamp": "2026-05-30T18:16:48.313Z",
        "request_id": "af30cf9e-0afd-4479-a664-a358168ddb33"
    },
    "status": "ok",
    "message": "MAC generated",
    "success": true
}
```

#### `GET /v1/lookup` — Vendor for a MAC / OUI

**Parameters:**
- `mac` (query, required, string) — MAC address or OUI (any format) Example: `00:1B:44:11:3A:B7`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/macvendor-api/v1/lookup?mac=00%3A1B%3A44%3A11%3A3A%3AB7"
```

**Response:**
```json
{
    "data": {
        "oui": "00:1B:44",
        "input": "00:1B:44:11:3A:B7",
        "vendor": "SanDisk Corporation",
        "block_size": "/24",
        "is_private": false,
        "vendor_short": "SanDisk"
    },
    "meta": {
        "timestamp": "2026-05-30T18:16:48.397Z",
        "request_id": "81bbb25a-db29-483c-ac58-fe16c347a649"
    },
    "status": "ok",
    "message": "Vendor retrieved",
    "success": true
}
```

#### `GET /v1/search` — Find OUIs by vendor name

**Parameters:**
- `q` (query, required, string) — Vendor name Example: `apple`
- `limit` (query, optional, string) — 1-200 (default 25) Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/macvendor-api/v1/search?q=apple&limit=25"
```

**Response:**
```json
{
    "data": {
        "count": 25,
        "query": "apple",
        "results": [
            {
                "oui": "10:00:20",
                "vendor": "Apple, Inc.",
                "block_size": "/24",
                "vendor_short": "Apple"
            },
            {
                "oui": "10:29:59",
                "vendor": "Apple, Inc.",
                "block_size": "/24",
                "vendor_short": "Apple"
            },
            {
                "oui": "10:30:25",
                "vendor": "Apple, Inc.",
                "block_size": "/24",
                "vendor_short": "Apple"
            },
            {
                "oui": "10:42:10",
                "vendor": "Apple, Inc.",
                "block_size": "/24",
                "vendor_short": "Apple"
            },
            {
                "oui": "14:28:76",
                "vendor": "Apple, Inc.",
                "block_size": "/24",
                "vendor_short": "Apple"
            },
            {
                "oui": "14:85:09",
                "vendor": "Apple, Inc.",
                "block_size": "/24",
                "vendor_short": "Apple"
            },
            {
                "oui": "14:98:77",
                "vendor": "Apple, Inc.",
                "block_size": "/24",
                "vendor_short": "Apple"
            },
            {
                "oui": "18:20:32",
                "vendor": "Apple, Inc.",
                "block_size": "/24",
               
…(truncated, see openapi.json for full schema)
```


---
Marketplace page: https://www.oanor.com/api/macvendor-api
OpenAPI spec: https://www.oanor.com/api/macvendor-api/openapi.json