Skip to main content
All BETA API requests require Bearer-token authentication. There is no other auth method.

​
Get a key

Email hello@getbeta.io. Keys are issued manually during developer preview. Self-serve signup is on the Roadmap.

​
Sending the key

Include the key as a Bearer token in the Authorization header: 
curl -X POST https://api.getbeta.io/api/v1/validate \
  -H "Authorization: Bearer $BETA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"company": "Anthropic"}'

​
Environment-variable convention

Store your key as BETA_API_KEY: 
# .env or shell profile
export BETA_API_KEY=your_key_here
The official MCP server reads BETA_API_KEY automatically.

​
Errors

StatusCause
401 UnauthorizedMissing or invalid Authorization header
403 ForbiddenValid key but no permission for this endpoint (rare)
429 Too Many RequestsRate limit exceeded — see Pricing for per-tier limits

​
Key rotation

Email hello@getbeta.io to rotate your key. Old key is revoked immediately on issuance of the new one.

​
Coming soon

Self-serve signup, key management dashboard, and programmatic key rotation are queued for the next release. See Roadmap.