API Reference
REST endpoints for searching infrastructure concessions and retrieving detail, sectors, countries, operators, and aggregate stats.
Base URL https://app.concessio.io. Authentication and rate limits are on the Authentication page. The public per-ID lookup (/api/v1/id/{CCID}) needs no key; every other endpoint does.
GET /api/v1/concessions — Search
Primary discovery endpoint for searching 22,000+ infrastructure concessions. Supports full-text search, country/sector/operator filtering, expiry date ranges, and pagination.
| Parameter | Type | Description |
|---|---|---|
| q | string | Full-text search across name, country, operator, sector |
| country | string | Country name, comma-separated for multiple |
| sector | string | Airport, Toll Road, Port, Water, Rail, Waste Management, Marina, Power Distribution, Gas Distribution, Transmission, Social Infrastructure, District Heating, Energy Generation, Telecom, Other Infrastructure |
| expires_before | date | ISO 8601 — concessions expiring before this date |
| expires_after | date | ISO 8601 — concessions expiring after this date |
| operator | string | Fuzzy match on operator/concessionaire name |
| status | string | Active, Expired, Awarded, Under Procurement |
| sort | string | end_date, value, name, country (default: end_date) |
| order | string | asc or desc (default: asc) |
| page | number | Page number (default: 1) |
| per_page | number | Results per page (default: 25, max: 100) |
GET /api/v1/concessions/:id — Detail
Full detail for a single infrastructure concession including ownership history and financial context where held. Records carry the five contract dates separately (award, signing, financial close, term start, operations start) and a date is empty unless a cited evidence entry backs it.
GET /api/v1/sectors
Valid sector values with concession counts. Helps AI agents understand available infrastructure categories in the Concessio database.
GET /api/v1/countries
All countries with infrastructure concession counts and region mapping. Helps agents validate country names and discover Concessio's geographic coverage across 189 countries.
GET /api/v1/operators
Search infrastructure operators and concessionaires. Supports fuzzy matching. Returns operator name and concession count. Covers thousands of operators including Vinci, Ferrovial, Transurban, Macquarie, Brookfield, Meridiam, DIF, and more.
GET /api/v1/stats
Aggregate statistics about the Concessio infrastructure concession database: total concessions (22,000+), breakdown by sector and region, concessions expiring within 12/24/36 months. Best first call for an AI agent to understand data scope.