---
title: "Verify a license by number, or search licensees by name. Free (not metered)."
method: GET
path: "/v1/verify"
---

# Verify a license by number, or search licensees by name. Free (not metered).

`GET /v1/verify`

## Request

- Base URL: `https://api.americantradesindex.com`
- URL: `https://api.americantradesindex.com/v1/verify`
- Auth: HTTP bearer

## Query parameters

- `state` string, required
- `license` string
- `name` string
- `limit` integer

## Response `200`

matches[] with status, trade, tier, expiry and the register facts

## Other responses

- `400`: invalid_request: detail names the field
- `401`: unauthorized: missing, invalid or revoked key
- `402`: upgrade_required (no active plan), credits_exhausted (period pool used up) or payment_required (last charge failed); body carries an `upgrade` URL
- `429`: rate_limited (120/min per workspace). Every response carries RateLimit-Limit/Remaining/Reset/Policy; a 429 adds Retry-After

---

[API](https://skmtc.dev/americantradesindex/apis/american-trades-index-api.md) · [All operations](https://skmtc.dev/americantradesindex/apis/american-trades-index-api/llms.txt) · [OpenAPI document](https://skmtc.dev/americantradesindex/apis/american-trades-index-api/revisions/5a9de4d8c76b?raw)