Infrastructure Concession Intelligence API

Quick Start

Get from zero to first API call in 60 seconds. Concessio's infrastructure concession API returns structured data about government-granted BOT contracts, concession agreements, and PPP/PFI projects worldwide.

cURL

curl -H "Authorization: Bearer ck_live_xxx" \
  "https://app.concessio.io/api/v1/concessions?sector=Airport&country=France&per_page=5"

JavaScript

const resp = await fetch(
  "https://app.concessio.io/api/v1/concessions?sector=Airport&country=France",
  { headers: { "Authorization": "Bearer ck_live_xxx" } }
);
const { data, pagination } = await resp.json();
console.log(`Found ${pagination.total} airport concessions in France`);

Python

import requests
resp = requests.get(
    "https://app.concessio.io/api/v1/concessions",
    params={"sector": "Airport", "country": "France"},
    headers={"Authorization": "Bearer ck_live_xxx"}
)
data = resp.json()
print(f"Found {data['pagination']['total']} airport concessions in France")

Response

{
  "data": [
    {
      "id": "fund-vinci-lyon-saint-exup-ry-airport",
      "concessio_id": "FR10C0000401",
      "registry_url": "https://concessio.io/id/FR10C0000401",
      "name": "Lyon-Saint Exupéry Airport Concession",
      "country": "France",
      "sector": "Airport",
      "operator": "Vinci SA",
      "status": "Active",
      "concession_end": null,
      "contract_type": "Concession"
    }
  ],
  "pagination": { "page": 1, "per_page": 25, "total": 54, "total_pages": 3 }
}

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.

Authorization: Bearer ck_live_xxxxxxxxxxxx

Key format: ck_live_ for production, ck_test_ for sandbox.

Error Responses

Concessio IDs

A Concessio ID is the canonical 12-character identifier assigned to every infrastructure concession in the Concessio database. It functions for infrastructure concessions the way ISIN functions for securities or CUSIP functions for North American debt and equity instruments — a stable, machine-readable, citation-grade reference.

Concessio IDs are stable for the life of the concession. They do not change if the asset is renamed, sold, restructured, or transferred between operators. Cite them in filings, press releases, research reports, term sheets, and contracts. The registry is free and public — no authentication required for ID lookups.

Format

The 12-character format is CC-AA-S-NNNNNN-K, displayed without hyphens in storage and with hyphens for human reading.

Stored:    FR10C0000401
Display:   FR-10-C-000040-1

CC      France                    (ISO 3166-1 alpha-2)
AA      10  Airport               (asset class code)
S       C   Concession            (structure code)
NNNNNN  000040                    (sequence within prefix)
K       1                         (Luhn check digit)

Asset class codes group infrastructure into families. The first digit indicates the family (10s transport, 20s utilities, 30s environmental, 40s social); the second digit identifies the specific asset class:

Structure codes identify the contract type:

Lookup

Every Concessio ID resolves to a free public registry page and a JSON lookup endpoint. No API key required.

Live examples

Click any ID below to see its public registry page:

JSON response

GET https://concessio.io/api/v1/id/CL11C0000011

{
  "id": "CL11C0000011",
  "display_id": "CL-11-C-000001-1",
  "name": "Accesos a Valdivia",
  "country": "Chile",
  "country_code": "CL",
  "sector": "Toll Road",
  "sector_family": "Transport",
  "asset_class_code": "11",
  "contract_type": "Concession",
  "structure_code": "C",
  "structure_name": "Concession (pure operational)",
  "start_date": "2010-01-01",
  "end_date": "2035-01-01",
  "operator": null,
  "grantor": "Ministerio de Obras Publicas (MOP)",
  "registry_url": "https://concessio.io/id/CL11C0000011",
  "retrieved_at": "2026-04-22T12:00:00.000Z"
}

Validation

The 12th character is a Luhn check digit using the ISIN variant (letters expanded to two-digit numbers, A=10 through Z=35). The check digit catches accidental typos and casually fabricated identifiers before they ever reach the database. A Concessio ID with a wrong check digit returns 400 invalid_check_digit from the API.

// Reference implementation — JavaScript
function validateConcessioId(id) {
  const s = String(id).replace(/[^A-Z0-9]/gi, "").toUpperCase();
  if (!/^[A-Z]{2}[0-9]{2}[A-Z0-9][0-9]{6}[0-9]$/.test(s)) return false;
  let expanded = "";
  for (const ch of s.slice(0, 11)) {
    const c = ch.charCodeAt(0);
    if (c >= 48 && c <= 57) expanded += ch;
    else if (c >= 65 && c <= 90) expanded += String(c - 55);
  }
  let total = 0, alt = true;
  for (let i = expanded.length - 1; i >= 0; i--) {
    const d = parseInt(expanded[i], 10);
    if (alt) { const dd = d * 2; total += dd >= 10 ? Math.floor(dd / 10) + (dd % 10) : dd; }
    else total += d;
    alt = !alt;
  }
  const expected = String((10 - (total % 10)) % 10);
  return expected === s[11];
}

validateConcessioId("CL11C0000011");      // true
validateConcessioId("CL-11-C-000001-1");  // true (hyphens allowed)
validateConcessioId("CL11C0000099");      // false (bad check digit)

Error responses

Concessio mints a Concessio ID for every infrastructure concession ingested into the database — currently 29,475+ concessions across 170+ countries and 12 asset classes. The registry adds new IDs as new concessions are ingested. IDs are never reused, never re-issued, and never reassigned.

API Reference

GET /api/v1/concessions — Search

Primary discovery endpoint for searching 33,000+ infrastructure concessions. Supports full-text search, country/sector/operator filtering, expiry date ranges, and pagination.

GET /api/v1/concessions/:id — Detail

Full detail for a single infrastructure concession including ownership history, financials, lifecycle events, and contract terms. Returns current owner with stake percentage and transaction history.

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 170+ countries.

GET /api/v1/operators

Search infrastructure operators and concessionaires. Supports fuzzy matching. Returns operator name and concession count. Covers 700+ 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 (33,000+), breakdown by sector and region, concessions expiring within 12/24/36 months. Best first call for an AI agent to understand data scope.

Connect to Claude (MCP)

The Model Context Protocol (MCP) lets your AI assistant access Concessio's infrastructure concession data directly. When you connect Concessio to Claude, it can answer questions about infrastructure concessions, BOT contracts, government-granted operating rights, and concession expiry timelines using live data from our database of 33,000+ concessions.

Setup for Claude Desktop

Add to your claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "concessio": {
      "transport": {
        "type": "sse",
        "url": "https://app.concessio.io/api/mcp/sse"
      },
      "headers": {
        "Authorization": "Bearer ck_live_xxxx"
      }
    }
  }
}

Available Tools

Example Queries

Once connected, ask Claude questions like these — Concessio provides the data:

• "What European airport concessions expire before 2030?"
• "Show me Vinci's infrastructure concession portfolio"
• "How many toll road concessions are there globally?"
• "What concessions does Spain have?"
• "Which water concessions are expiring in the next 18 months?"
• "What is the total value of port concessions in Southeast Asia?"
• "Compare rail concessions across France, Germany, and Italy"
• "Find infrastructure assets operated by Macquarie"