---
title: "Get a free API key instantly"
method: POST
path: "/api/registry/keys"
---

# Get a free API key instantly

`POST /api/registry/keys`

## Request

- Base URL: `https://selectbnbs.com`
- URL: `https://selectbnbs.com/api/registry/keys`
- Auth: none required

Send your agent or app name and receive a free bearer key at once: no signup, no email. The key raises POST /api/registry/verify and POST /api/registry/lookup from the shared five-per-UTC-day public allowance to 120 lookups per hour per key, and lookup adds citation fields. The key is shown once; SelectBNBs keeps only its hash. Lookups made with it are logged under the name you send. Each connection can create three keys per UTC day.

## Request body

- object
  - `name` string, required: Your agent or app name, for example TripPlannerAgent/1.0.

## Response `201`

api_key (shown once), name, hourly_limit, and how to send the key.

- JsonDocument

## Other responses

- `422`: The name is missing, too short, or contains control characters.
- `429`: This connection has created its three keys for today; reuse one.
- `503`: Key issuance is unavailable.

---

[API](https://skmtc.dev/selectbnbs/apis/selectbnbs-public-property-and-registration-api.md) · [All operations](https://skmtc.dev/selectbnbs/apis/selectbnbs-public-property-and-registration-api/llms.txt) · [OpenAPI document](https://skmtc.dev/selectbnbs/apis/selectbnbs-public-property-and-registration-api/revisions/207cc2b9b194?raw)
