Authentication & Rate Limits
Concessio uses API keys for authentication. Pass your key via the Authorization header. API keys are tied to your organization and plan tier.
Last updated July 29, 2026
How do I authenticate to the Concessio API?
Authorization: Bearer ck_live_xxxxxxxxxxxx
Key format: ck_live_ for production, ck_test_ for sandbox.
What are the rate limits per plan?
| Plan | Rate Limit | Access | Price |
|---|---|---|---|
| Screen | 100 req/hr | Search + basic fields | $750/mo |
| Advise | 500 req/hr | Full detail + financials + ownership | $2,500/mo |
| Manage | 2,000 req/hr | Full detail + portfolio + bulk | Custom |
Error Responses
| Status | Code | Description |
|---|---|---|
| 400 | invalid_params | Malformed query parameters |
| 401 | unauthorized | Missing or invalid API key |
| 403 | plan_restricted | Endpoint not available on current plan |
| 404 | not_found | Concession ID does not exist |
| 429 | rate_limited | Rate limit exceeded — includes retry_after |
| 500 | internal_error | Server error |