CBS StatLine

Basisadres

https://opendata.cbs.nl

Endpoints 17

• GET/ODataCatalog/Tables?$format=jsonAlle tabellen in één antwoord (18 MB): Identifier, Title, ShortDescription, Modified, Frequency, Period, OutputStatus, RecordCount, ColumnCount, ApiUrl, FeedUrl. $filter, $select, $orderby en $top werken hier.
• GET/ODataCatalog/Themes?$format=jsonDe themaboom van StatLine: 1.293 thema's met ID, ParentID, Number en Title.
• GET/ODataCatalog/Tables_Themes?$format=jsonKoppeling tabel en thema (8.162 regels; een tabel kan in meer thema's staan).
• GET/ODataCatalog/Featured?$format=jsonDe 12 uitgelichte onderwerpen; Table_Featured koppelt ze aan tabellen.
• GET/ODataApi/OData/{tabel}Dienstdocument van één tabel: TableInfos, UntypedDataSet, TypedDataSet, DataProperties, CategoryGroups en één endpoint per dimensie.
• GET/ODataApi/OData/{tabel}/TableInfosTitel, samenvatting, periode, frequentie, status en wijzigingsdatum (Modified).
• GET/ODataApi/OData/{tabel}/DataPropertiesAlle kolommen: dimensies (Dimension, TimeDimension, GeoDetail), onderwerpen (Topic, met Unit en Decimals) en groepen (TopicGroup).
• GET/ODataApi/OData/{tabel}/{Dimensie}Codes (Key), namen en beschrijvingen van één dimensie, bv. /RegioS of /Perioden.
• GET/ODataApi/OData/{tabel}/TypedDataSetDe cijfers als getallen, één kolom per onderwerp. Maximaal 10.000 rijen per antwoord.
• GET/ODataApi/OData/{tabel}/UntypedDataSetDezelfde cijfers als tekst (soms met voorloopspaties: " 13199"), inclusief symbolen voor ontbrekende waarden.
• GET/ODataApi/OData/{tabel}/TypedDataSet/$countAantal rijen van de tabel (37230ned: 196.160).
• GET/ODataApi/OData/{tabel}/$metadataVolledig datamodel (XML, EDMX).
• GET/ODataFeed/OData/{tabel}/TypedDataSetZelfde data als Atom-XML in pagina's van 10.000 met <link rel="next"> ($skip). Voor de hele tabel; let op de filtervalkuil hieronder.
• GEThttps://datasets.cbs.nl/odata/v1/CBS/DatasetsNieuwe API (OData v4): alle 4.894 Nederlandse datasets met Identifier, Title, Modified, Status, ObservationCount en Distributions (CSV-download). $filter (ook contains()), $orderby en $select werken.
• GEThttps://datasets.cbs.nl/odata/v1/CBS/{tabel}Eén dataset in v4: Properties (beschrijving, versie, status), Dimensions, MeasureCodes, MeasureGroups, {Dimensie}Codes, {Dimensie}Groups en Observations.
• GEThttps://datasets.cbs.nl/odata/v1/CBS/{tabel}/ObservationsLange vorm: één rij per cijfer (Id, Measure, ValueAttribute, Value, StringValue, dimensies). 100.000 per pagina met @odata.nextLink; $count met filter werkt.
• GEThttps://datasets.cbs.nl/csv/CBS/nl/{tabel}Hele dataset als ZIP met CSV's (37230ned: 16,7 MB, bestandsnaam met versie: 37230ned-202609300000.zip).

De API's van deze bron 2 · uit de documentatie van de aanbieder uit de beschrijving

Filteren getest

OData-expressies in $filter. Sleutels tussen enkele aanhalingstekens; in v3 aangevuld met spaties tot een vaste lengte, in v4 zonder. Alleen dimensies zijn filterbaar.

Parameters 6

Velden in de catalogus (ODataCatalog/Tables) 9

Limieten en valkuilen

• OData v3 (/ODataApi/): meer dan 10.000 rijen geeft HTTP 500 "Please redefine your query so that it returns less than 10000 records". /ODataFeed/ pagineert per 10.000. getest
• OData v4 (datasets.cbs.nl): maximaal 100.000 cellen per antwoord, volg @odata.nextLink. $top boven 100.000 geeft 400. getest
• Geen sleutel en geen gepubliceerde rate limit. opendata.cbs.nl gaf op 16 okt 2026 een tijd lang HTTP 503 (Service Unavailable) en hing eerder die dag soms een minuut: gebruik time-outs en probeer later opnieuw. getest
• Sleutels in v3 zijn met spaties aangevuld tot de langste code van die dimensie: 'NL01 ' en 'GM0363' (RegioS, 6 tekens) maar 'GM0363 ' (WijkenEnBuurten, 10 tekens). Zonder opvulling krijg je een lege lijst, geen fout. Lees de lengte uit /{Dimensie}. In v4 zijn sleutels niet aangevuld; mét spaties krijg je daar juist niets. getest
• In v3 werkt $filter alleen op dimensies. Een filter op een onderwerp (Overledenen_3 gt 12000) wordt zonder melding genegeerd en geeft alle rijen. v4 is eerlijker: filteren op Value geeft 400 "cannot be used in the $filter query option". getest
• Het Feed-endpoint (/ODataFeed/) past alleen het eerste $filter-predicaat toe en negeert de rest zonder melding. ervaring
• Perioden-codes: 2025JJ00 (jaar), 2026KW02 (kwartaal), 2026MM08 (maand). Een * in de titel of Status 'Voorlopig' (v4 PeriodenCodes) = voorlopig cijfer. Oude perioden worden bijgesteld: haal reeksen altijd helemaal opnieuw op. getest
• Onderwerp-codes verschillen tussen v3 (Overledenen_3, nummer schuift per tabelversie) en v4 (M000134, vast over tabellen heen). CBS-dataset 900002NED (in v4) zet ze om: per tabel OData3Identifier naar OData4Identifier. getest
• v4 kent alleen de Nederlandstalige CBS-tabellen (0 Engelse, geen dataderden). De Engelse tabellen (…ENG) en de tabellen van derden (politie, RIVM: dataderden.cbs.nl) staan alleen in v3. getest
• v4 $metadata geeft 406 met de standaard Accept-kop van curl (*/*); stuur Accept: application/xml. ReleaseCalendar deed er 28 s over en was leeg. $apply wordt niet ondersteund. Het adres odata4.cbs.nl (oude bèta) bestaat niet meer (DNS). getest
• TableInfos.Modified verandert bijna dagelijks (ook bij metadata). Voor versheid: de hoogste Perioden-code, of in v4 ObservationsModified. ervaring
• robots.txt van opendata.cbs.nl verbiedt /ODataAPI/OData/*, /ODataFeed/OData/* en /ODataCatalog/OData/* (met Noindex, voor zoekmachines). De gedocumenteerde paden schrijven /ODataApi/ (andere hoofdletters) en /ODataCatalog/Tables. datasets.cbs.nl en dataderden.cbs.nl hebben geen robots.txt (404). getest
• Python urllib (LibreSSL op macOS) faalt op de TLS van cbs.nl; gebruik curl, Node fetch of de pakketten cbsodata (Python) en cbsodataR (R). ervaring

Probeer het HTTP 200 · 328 ms · 16 okt

https://opendata.cbs.nl/ODataCatalog/Tables?$format=json&$orderby=Modified desc&$top=3&$select=Identifier,Title,Modified,Period,RecordCount,ApiUrl

{
  "odata.metadata": "https://opendata.cbs.nl/ODataCatalog/$metadata#Tables&$select=Identifier,Title,Modified,Period,RecordCount,ApiUrl",
  "value": [
    {
      "Identifier": "81901NED",
      "Title": "Beloningsverschillen tussen mannen en vrouwen; kenmerken baan, werknemer",
      "Modified": "2026-10-16T02:00:00",
      "Period": "2008-2025",
      "ApiUrl": "https://opendata.cbs.nl/ODataApi/OData/81901NED",
      "RecordCount": 468
    },
    {
      "Identifier": "81920NED",
      "Title": "Beloningsverschillen tussen mannen en vrouwen; bedrijfstakken (SBI 2008)",
      "Modified": "2026-10-16T02:00:00",
      "Period": "2008-2025",
      "ApiUrl": "https://opendata.cbs.nl/ODataApi/OData/81920NED",
      "RecordCount": 522
    }
  ]
}

Ingekort antwoord, opgeslagen bij het oogsten. Klik op het adres voor het echte, actuele antwoord.