---
title: "Search the registered vendor/block directory"
method: GET
path: "/v1/vendors"
---

# Search the registered vendor/block directory

`GET /v1/vendors`

## Request

- Base URL: `https://api.macadress.com`
- URL: `https://api.macadress.com/v1/vendors`
- Auth: one of:
  - HTTP bearer
  - API key in query parameter `api_key`
- TypeScript: <https://skmtc.dev/macadress/apis/macadress-com-api/docs/v1/vendors/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `query` string
- `country` string
- `limit` integer

## Response `200`

Matching non-private blocks. Counts as one call against the plan quota.

- VendorSearchResult
  - `total` integer: How many blocks match
  - `blocks` VendorBlock[]
    - `prefix_int` integer: The block's registered prefix
    - `mask_bits` 24 | 28 | 36
    - `block_type` 'MA-L' | 'MA-M' | 'MA-S' | 'IAB' | 'CID'
    - `organization` string
    - `address` string
    - `country` string: ISO 3166-1 alpha-2
    - `is_private` boolean
    - `first_seen_at` string, date-time
    - `last_changed_at` string, date-time

## Other responses

- `401`: Missing or invalid API key
- `429`: Requests-per-minute limit exceeded for the authenticated plan

---

[API](https://skmtc.dev/macadress/apis/macadress-com-api.md) - [All operations](https://skmtc.dev/macadress/apis/macadress-com-api/llms.txt) - [OpenAPI document](https://skmtc.dev/macadress/apis/macadress-com-api/revisions/b25e0c82f1a1?raw)