Keys and limits

Keys and plans

Waity works without a key. A free key raises the daily limit, and paid plans raise it further.

Get a key

Without a key you get 100 calls a day. A free key gives 1,000.

curl -X POST https://api.waity.ai/v1/keys \
  -H "Content-Type: application/json" \
  -d '{"email":"YOUR_EMAIL"}'

{
  "key": "wk_…",
  "tier": "free",
  "daily_limit": 1000,
  "header": "X-Api-Key"
}

The key is shown once, so store it.

Send it

Send the key as X-Api-Key or Authorization: Bearer on every call.

curl "https://api.waity.ai/v1/places/pl_xaed7pr1f5?view=minimal" \
  -H "X-Api-Key: $WAITY_API_KEY"

A hosted MCP connector that takes only a URL can carry it: https://api.waity.ai/mcp?key=wk_….

Replace a key

Asking again for the same email doesn't make a second key: Waity emails a link that replaces it, and the old key then stops working. Where it can't send email, it answers 409 key_exists.

Plans

Higher limits come with a paid plan; see Pricing.