Authentication & limits

Auth

Every request to the AIDRAN API requires a Bearer token. Keys are issued per reader account and rotated through the developer console.

01

Register

Create a reader account at aidran.ai. Free tier included.

02

Generate a key

Open Settings → API keys and create a key. The full secret is shown once, at creation — store it then.

03

Include in requests

Add the Authorization header to every request. Keys are scoped to your account.

Authorization header — required on all endpoints
$ curl -H "Authorization: Bearer adr_••••••••" https://app.aidran.ai/v1/records

# Keys carry the adr_ prefix; the full secret is shown once, at creation
# Keys are not scoped to a specific endpoint — they grant full read access

Rate limits

Hobbyist (free)60 req / minDefault for new accounts. No live SSE stream access.
Plus120 req / minNo live SSE stream access.
Pro600 req / minUp to 5 concurrent SSE stream connections.
Teams600 req / minPer seat. Up to 10 concurrent SSE stream connections.
EnterprisecustomSet per contract. Up to 50 concurrent SSE stream connections.

Error codes

401UnauthorizedMissing or invalid Authorization header. Include a valid Bearer token.
403ForbiddenKey is valid but does not have access to this endpoint or resource.
429Too Many RequestsRate limit exceeded. Check the Retry-After header for the backoff window.
503Service UnavailableDelivery gateway temporarily unavailable. Retry with exponential backoff.
Key management

Create, rotate, and revoke keys at Settings → API keys. The full secret is shown once, at creation; the console lists each key's prefix, creation date, and active state.

Get started

Ready to build?

Create a free reader account to receive your API key. No credit card required at the free tier — 60 req/min, all 40 endpoints.

Create reader account →View reference