API · v1-20260518

Bouw op de open data

The Cracks Index is gepubliceerd om gebruikt te worden, niet alleen om te lezen. Dezelfde getallen die de microsite voeden, zijn als gewone JSON beschikbaar. Geen account, geen sleutel, geen limiet om mee te beginnen.

Het begin

Wat je moet weten

Basis-URL

https://api.fynqo.app

Alleen lezen

Elk endpoint is een GET-verzoek. Er valt niets te schrijven, niets in te loggen. Een verzoek met curl of een fetch in de browser is genoeg.

Geen persoonsgegevens

Elke waarde is een publiek aggregaat op land- of gebiedsniveau. Er komt geen enkel persoonsgegeven door de API, dus voor hergebruik is geen AVG-grondslag nodig.

Stabiele momentopnames

Elke respons draagt een momentopname-versie. Zolang je naar dezelfde versie verwijst, blijven de cijfers exact gelijk, ook nadat een nieuwe ronde is gepubliceerd.

Faalt zacht

Ontbreekt er data, dan geeft een endpoint een schone, lege 200 terug in plaats van een fout. Je code hoeft geen 500 op te vangen.

In elke respons

Elke respons bevat een veld caveat en een veld citation. Het eerste legt de levende-v0-kadering uit, het tweede geeft je een kant-en-klare bronvermelding. Cijfers die gemodelleerd zijn, zoals de Cracks Clock, dragen daarnaast is_estimate.

De endpoints

Vier publieke endpoints

Hieronder staat elk publiek endpoint met zijn pad, parameters en de vorm van de respons. De voorbeeldwaarden zijn illustratief; de echte cijfers haal je live op.

GET /api/cracks/index

De volledige ranglijst

Geeft de complete landenranglijst voor de live momentopname. Elk land heeft een samengestelde score en een rang, gesorteerd van laag naar hoog.

Parameters

Geen parameters.

Vorm van de respons 
{
  "meta": {
    "snapshot_version": "v0.3",
    "snapshot_date": "2026-05-12",
    "methodology_version": "v0",
    "is_published": "live",
    "country_count": 41
  },
  "ranking": [
    {
      "country_iso3": "NLD",
      "country_name": "Nederland",
      "composite_score": 28.4,
      "rank": 7,
      "indicator_count": 6
    }
  ],
  "caveat": "...",
  "citation": "Fynqo, The Cracks Index (v0.3, 2026-05-12). ..."
}
GET /api/cracks/country/{iso3}

Eén land

Geeft de score, rang, de uitsplitsing in zes indicatoren en de fix voor één land. Het pad-segment iso3 is een ISO-3166 alpha-3-landcode.

Parameters
  • iso3 pad · verplicht — ISO-3166 alpha-3-landcode, bijvoorbeeld NLD of DEU.
Vorm van de respons 
{
  "meta": { "snapshot_version": "v0.3", "snapshot_date": "2026-05-12", "...": "..." },
  "country": {
    "country_iso3": "NLD",
    "country_name": "Nederland",
    "composite_score": 28.4,
    "rank": 7,
    "indicator_count": 6
  },
  "indicators": [
    {
      "indicator_key": "problem_debt",
      "label": "% households with problematic debt",
      "raw_value": 8.1,
      "unit": "% of households",
      "normalized_score": 31.2,
      "source": "Eurostat SILC",
      "source_date": "2024"
    }
  ],
  "fix": {
    "indicator_key": "mh_treatment_gap",
    "label": "Unmet mental-health care need (%)",
    "fix_description": "...",
    "estimated_impact": 4.6
  },
  "caveat": "...",
  "citation": "..."
}
GET /api/cracks/regions

Subnationale gebieden

Geeft een gerangschikte lijst van subnationale gebieden op één niveau. Met level kies je tussen EU-regio’s en Nederlandse gemeenten; met country filter je op één land.

Parameters
  • level query · optioneel — Niveau: nuts2 (EU-regio’s) of gemeente. Standaard nuts2.
  • country query · optioneel — Optioneel ISO-3166 alpha-3-landfilter, bijvoorbeeld NLD.
Vorm van de respons 
{
  "meta": {
    "snapshot_version": "v0.3",
    "snapshot_date": "2026-05-12",
    "region_count": 12,
    "...": "..."
  },
  "level": "nuts2",
  "country": "NLD",
  "regions": [
    {
      "region_level": "nuts2",
      "region_code": "NL32",
      "region_name": "Noord-Holland",
      "country_iso3": "NLD",
      "country_name": "Nederland",
      "composite_score": 26.9,
      "rank": 3,
      "indicator_count": 6
    }
  ],
  "caveat": "...",
  "citation": "..."
}
GET /api/cracks/region/{region_code}

Eén gebied

Geeft één subnationaal gebied: score, rang binnen het eigen niveau, de uitsplitsing in indicatoren en de fix. Een gebied wordt alleen tegen andere gebieden op hetzelfde niveau gerangschikt.

Parameters
  • region_code pad · verplicht — Gebiedscode, bijvoorbeeld NL32 (regio) of GM0363 (gemeente).
Vorm van de respons 
{
  "meta": { "snapshot_version": "v0.3", "snapshot_date": "2026-05-12", "...": "..." },
  "region": {
    "region_level": "nuts2",
    "region_code": "NL32",
    "region_name": "Noord-Holland",
    "country_iso3": "NLD",
    "country_name": "Nederland",
    "composite_score": 26.9,
    "rank": 3,
    "indicator_count": 6
  },
  "rank_within_level": 3,
  "level_count": 12,
  "indicators": [ { "indicator_key": "problem_debt", "...": "..." } ],
  "fix": { "indicator_key": "eviction_rate", "...": "..." },
  "caveat": "...",
  "citation": "..."
}
Licentie

Hoe je de data mag gebruiken en vermelden

De data van The Cracks Index is gepubliceerd onder Creative Commons Attribution 4.0 (CC-BY-4.0). Je mag deze hergebruiken, verspreiden en erop voortbouwen, ook commercieel en in een eigen product, zolang je Fynqo als bron vermeldt. Elke respons bevat een veld citation met een kant-en-klare regel. Gebruik die, of deze:

Fynqo (2026). The Cracks Index, v1-20260518. Momentopname van 2026-05-18. Gelicentieerd onder CC-BY-4.0. https://fynqo.app/cracks-index/

De API is volledig read-only en bevat uitsluitend publieke, geaggregeerde cijfers op land- en gebiedsniveau. Er worden geen persoonsgegevens verwerkt of teruggegeven.

CC-BY-4.0 Read-only 40 landen Momentopname 2026-05-18 v1-20260518

Begrijp eerst het rekenwerk

Voordat je de cijfers verwerkt, loont het om te weten hoe ze zijn opgebouwd: welke zes indicatoren, met welke gewichten, uit welke bronnen.

Lees de methodologie Bekijk de ranglijst