Waardelaag · API

Distributiemonitor Financieel — API-handleiding

De volledige API-referentie: 16 metrics, entiteitenhiërarchie, wijzigingslog en producten. Alle endpoints zijn zonder account te proberen (free preview); productietegang vereist een API-key.

1 · Introductie 2 · Aan de slag 3 · Datamodel 4 · Metrics (16 endpoints) 5 · Entiteitenhiërarchie 6 · Wijzigingslog & versies 7 · Producten-API's 8 · Foutafhandeling

1 · Introductie

De Distributiemonitor Financieel is het open, continue en interactieve beeld van financiële distributie in Nederland. De API levert alle cijfers machine-leesbaar, in dezelfde envelop als de rest van het platform (snake_case, ISO-8601, RFC 7807-fouten).

Actualisatiefrequentie: dagelijks (AFM-register, Kifid, DNB) tot maandelijks (GLEIF-relaties). Elke respons draagt bron, peildatum en dekking mee.

Dashboard vs. rapport: de API en het dashboard zijn leidend; het kwartaalrapport is een momentopname-export. De API loopt altijd door.

2 · Aan de slag

Alle endpoints zijn direct te proberen zonder account. Voor productiegebruik (rate limits, export) vraagt u een API-key aan via het dashboard.

eerste aanroep

curl https://Identix.org/v1/distributiemonitor/universum

Authenticatie & tiers

Tier	Rate limit	Scope	Export
free_preview	60 req/uur	alle metrics, laatste jaar	nee
standard	1.000 req/uur	volledige historie	CSV
enterprise	op maat	alles + webhooks + bulk export	ja

3 · Datamodel

De API kent drie entiteitstypen en tien metrics:

Entiteit	Beschrijving	Velden
`vestiging`	Fysieke advieslocatie	`vestiging_id`, `naam`, `kvk_nummer`, `postcode`, `huisnummer`, `plaats`, `actief`
`holding`	Entiteit met deelneming	`holding_id`, `naam`, `vestiging_ids[]`, `hoofdholding_id`, `type`
`hoofdholding`	Top van de eigendomsketen	`hoofdholding_id`, `naam`, `holding_ids[]`, `vestiging_ids[]`, `sector_rang`

4 · Metrics

Zestien endpoints onder /v1/distributiemonitor/, elk met bron, peildatum en dekking in de respons:

5 · Entiteitenhiërarchie

GET/v1/distributiemonitor/vestigingen

Doorzoek vestigingen; filter op postcode, kvk_nummer, actief.

GET/v1/distributiemonitor/holdings

Alle holdings met onderliggende vestigingen en dekking.

GET/v1/distributiemonitor/hoofdholdings

Top-rangschikking van hoofdholdings. Query: sector_rang_max.

GET/v1/distributiemonitor/hoofdholdings/{id}/structuur

Volledige eigendomsboom onder één hoofdholding.

GET/v1/distributiemonitor/samenwerkingsverbanden

Netwerken zonder kapitaalband: kantoren die samenwerken via AFM-relaties zonder GLEIF-eigendom (franchiseformules, inkoopverbanden). Top-20 op omvang, plus totaaltelling.

Relatieverkenner

GET/v1/distributiemonitor/relaties/zoeken?q=

Zoek entiteiten op (deel van) naam of KvK, met uitgaande/inkomende relatie-tellingen. q ≥ 2 tekens.

GET/v1/distributiemonitor/relaties/{instelling_id}

Structuur rond één entiteit: bovenliggende (moeder/volmachtgever) en onderliggende ondernemingen, recursief — elke node klikbaar.

GET/v1/distributiemonitor/relaties/netwerk?jaar=

Force-graaf-data (nodes + links) van de drukste structuren. Query: jaar (tijdslider: de graaf op 31-12 van dat jaar), max_nodes (default 90).

6 · Wijzigingslog & versies

Elke import publiceert een dataset_versie; de diff tussen versies produceert wijziging-rijen (append-only, as-of bevraagbaar).

GET/v1/distributiemonitor/versies

Alle dataset-versies met changelog.

GET/v1/distributiemonitor/versies/{id}/wijzigingen

Alle wijzigingen in één versie. Query: entiteit_type, wijziging_type.

7 · Producten-API's

Consolidatie Radar

GET/v1/distributiemonitor/radar

Consolidator-overzicht, doelwit-signalering en marktbeweging.

Mutatie Alerts

GET/v1/distributiemonitor/alerts/volglijst

Beheer uw volglijst. Query: gebruiker_id.

GET/v1/distributiemonitor/alerts/tijdlijn

Chronologische alert-feed. Query: gebruiker_id, ongelezen.

Peer Benchmark

GET/v1/distributiemonitor/benchmark

Peergroep-verdeling en eigen percentielpositie. Query: peergroep_seg (q1_smal · q2 · q3 · q4_breed), peergroep_regio (plaats), vestiging_id.

Consolidatiekans

GET/v1/distributiemonitor/kansmodel

Top-20 consolidatiekans-scores met richting (overname_kandidaat · zelf_consolidierend · monitoring) en publieke factorgewichten.

Hypotheekdistributie

GET/v1/distributiemonitor/hypotheek

Segment-diepte Hypothecair krediet: kern per dienstsoort, per-jaar-voorraad (tijdslider), vergunningsduur-cohorten (vergrijzingsproxy), spreiding per gemeente per 10k huishoudens, en consolidatie in het segment.

8 · Foutafhandeling

Fouten volgen RFC 7807 met een Nederlandstalige title en machine-leesbare errorCode:

HTTP	errorCode	Betekenis
404	`not_found`	Resource bestaat niet
422	`validation_error`	Ongeldige parameter
503	`...`	Onderliggende bron niet beschikbaar (detail zegt welke)

Machine-leesbaar: GET /v1/distributiemonitor (status) · GET /v1/distributiemonitor/methodiek (volledige metric-registry). Alle voorbeelddata in deze handleiding komt live uit de API.