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 the developer console in your reader dashboard and issue an API key.

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 aidran_live_••••••••" https://app.aidran.ai/v1/records

# Keys have the prefix aidran_live_ (production) or aidran_test_ (sandbox)
# Keys are not scoped to a specific endpoint — they grant full read access

Rate limits

Free tier60 req / minDefault for all new accounts
Burst limit10 req / sApplies across all tiers
SSE stream1 connectionOne active stream per key

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 console — coming with v1

The v1 release adds a full developer console: key generation, revocation, per-key quota dashboards, and higher-rate tiers. Available at aidran.ai/dev.

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