# 2s.io MAC Vendor Lookup

> 2s.io MAC Vendor Lookup is a paid API for AI agents from 2s.io, paid per call via x402, $0.0012/call, status unknown (last checked 2026-09-15).

Resolves a MAC address or OUI prefix to its IEEE-registered hardware manufacturer using longest-prefix matching across MA-L, MA-M, and MA-S registries

## Facts

- Endpoint: GET https://2s.io/api/net/mac-vendor
- Price: $0.0012/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/2s-io-mac-vendor-lookup-9b55872a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mcBpr2-FscIfo39VlBV5W

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability 2s-io-mac-vendor-lookup-9b55872a
```

Example prompt: Who makes the device with MAC address FC:FB:FB:01:02:03 — look up the IEEE-registered vendor and tell me which registry it came from and whether it's a randomized privacy address.

## When to prefer this

Use this endpoint when you need authoritative IEEE-sourced OUI-to-vendor resolution with longest-prefix matching across all three IEEE registries (MA-L, MA-M, MA-S). It is superior to simpler OUI lookups that only check the 24-bit MA-L registry, as it correctly resolves subdivided blocks to the actual manufacturer. Ideal for network forensics, device inventory enrichment, intrusion detection context, and validating whether a MAC is real vs. randomized.

## Known failure modes

- MAC address is a randomized/privacy address — no vendor can be assigned by design, endpoint returns flag indicating this
- OUI prefix not found in any IEEE registry — unknown or unregistered hardware
- Malformed MAC address string that cannot be parsed — likely a 400 error
- MA-S (36-bit) subdivision blocks may not resolve if IEEE data is stale

## How this service works

Resolve a MAC address (or bare OUI prefix) to its IEEE-registered hardware vendor. Accepts any common format — FC:FB:FB:01:02:03, fc-fb-fb-01-02-03, fcfb.fb01.0203, fcfbfb, or a 9-hex MA-S prefix. Uses longest-prefix matching across the IEEE MA-L (24-bit), MA-M (28-bit) and MA-S (36-bit) registries so blocks IEEE has subdivided resolve to the actual manufacturer. Returns the vendor name, the matched OUI prefix and which registry it came from, plus decoded address bits: whether the address is multicast/group, locally administered, or a randomized (privacy) MAC — for which no vendor exists by design. Authoritative bundled IEEE data.

## Output

Returns the IEEE-registered vendor name for the matched OUI, the specific OUI prefix that matched, the registry it came from (MA-L 24-bit, MA-M 28-bit, or MA-S 36-bit), and decoded address bits indicating whether the MAC is multicast/group, locally administered, or a randomized privacy MAC (for which no vendor exists).

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "mac": "00:1A:2B:3C:4D:5E"
  }
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "queryParams"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "required": [
      "mac"
     ],
     "properties": {
      "mac": {
       "type": "string",
       "description": "MAC address or OUI prefix in any common format."
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/2s-io-mac-vendor-lookup-9b55872a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 2s.io](https://www.zero.xyz/host/2s.io/llms.txt)