Sign in

v5

latestOpenAPI 3.0.3EUPL 1.2raw.githubusercontent.com2026-05-2769262387.9 KB
zaken

Voer een (geo)-zoekopdracht uit op ZAAKen.

Zoeken/filteren gaat normaal via de list operatie, deze is echter niet geschikt voor geo-zoekopdrachten.

post/zaken/_zoek

Query parameters

pageinteger

Een pagina binnen de gepagineerde set resultaten.

expandstring

Haal details van gelinkte resources direct op. Als je meerdere resources tegelijk wilt ophalen kun je deze scheiden met een komma. Voor het ophalen van resources die een laag dieper genest zijn wordt de punt-notatie gebruikt.

Headers

Content-Type'application/json' required

Content type van de verzoekinhoud.

Accept-Crs'EPSG:4326' required

Het gewenste 'Coordinate Reference System' (CRS) van de geometrie in het antwoord (response body). Volgens de GeoJSON spec is WGS84 de default (EPSG:4326 is hetzelfde als WGS84).

Content-Crs'EPSG:4326' required

Het 'Coordinate Reference System' (CRS) van de geometrie in de vraag (request body). Volgens de GeoJSON spec is WGS84 de default (EPSG:4326 is hetzelfde als WGS84).

Request body

uuid__instring[]

Array of unieke resource identifiers (UUID4)

identificatiestring

De unieke identificatie van de ZAAK binnen de organisatie die verantwoordelijk is voor de behandeling van de ZAAK.

bronorganisatiestring

Het RSIN van de Niet-natuurlijk persoon zijnde de organisatie die de zaak heeft gecreeerd. Dit moet een geldig RSIN zijn van 9 nummers en voldoen aan https://nl.wikipedia.org/wiki/Burgerservicenummer#11-proef

bronorganisatie__instring[]

Array van bronorganisaties.

zaaktypestring

URL-referentie naar het ZAAKTYPE (in de Catalogi API) in de CATALOGUS waar deze voorkomt

zaaktype__instring[]

Array van zaaktypen.

archiefnominatie'blijvend_bewaren' | 'vernietigen'

Aanduiding of het zaakdossier blijvend bewaard of na een bepaalde termijn vernietigd moet worden. Uitleg bij mogelijke waarden: * blijvend_bewaren - Het zaakdossier moet bewaard blijven en op de Archiefactiedatum overgedragen worden naar een archiefbewaarplaats. * vernietigen - Het zaakdossier moet op of na de Archiefactiedatum vernietigd worden.

archiefnominatie__instring[]

Multiple values may be separated by commas.

archiefactiedatumstring

De datum waarop het gearchiveerde zaakdossier vernietigd moet worden dan wel overgebracht moet worden naar een archiefbewaarplaats. Wordt automatisch berekend bij het aanmaken of wijzigen van een RESULTAAT aan deze ZAAK indien nog leeg.

archiefactiedatum__isnullboolean
archiefactiedatum__ltstring
archiefactiedatum__gtstring
archiefstatus'nog_te_archiveren' | 'gearchiveerd' | 'gearchiveerd_procestermijn_onbekend' | 'overgedragen'

Aanduiding of het zaakdossier blijvend bewaard of na een bepaalde termijn vernietigd moet worden. Uitleg bij mogelijke waarden: * nog_te_archiveren - De zaak cq. het zaakdossier is nog niet als geheel gearchiveerd. * gearchiveerd - De zaak cq. het zaakdossier is als geheel niet-wijzigbaar bewaarbaar gemaakt. * gearchiveerd_procestermijn_onbekend - De zaak cq. het zaakdossier is als geheel niet-wijzigbaar bewaarbaar gemaakt maar de vernietigingsdatum kan nog niet bepaald worden. * overgedragen - De zaak cq. het zaakdossier is overgebracht naar een archiefbewaarplaats.

archiefstatus__instring[]

Multiple values may be separated by commas.

startdatumstring

De datum waarop met de uitvoering van de zaak is gestart

startdatum__gtstring
startdatum__gtestring
startdatum__ltstring
startdatum__ltestring
registratiedatumstring

De datum waarop de zaakbehandelende organisatie de ZAAK heeft geregistreerd. Indien deze niet opgegeven wordt, wordt de datum van vandaag gebruikt.

registratiedatum__gtstring
registratiedatum__ltstring
einddatumstring

De datum waarop de uitvoering van de zaak afgerond is.

einddatum__isnullboolean
einddatum__gtstring
einddatum__ltstring
einddatumGeplandstring

De datum waarop volgens de planning verwacht wordt dat de zaak afgerond wordt.

einddatumGepland__gtstring
einddatumGepland__ltstring
uiterlijkeEinddatumAfdoeningstring

De laatste datum waarop volgens wet- en regelgeving de zaak afgerond dient te zijn.

uiterlijkeEinddatumAfdoening__gtstring
uiterlijkeEinddatumAfdoening__ltstring
rol__betrokkeneType'natuurlijk_persoon' | 'niet_natuurlijk_persoon' | 'vestiging' | 'organisatorische_eenheid' | 'medewerker'

Type van de betrokkene. Uitleg bij mogelijke waarden: * natuurlijk_persoon - Natuurlijk persoon * niet_natuurlijk_persoon - Niet-natuurlijk persoon * vestiging - Vestiging * organisatorische_eenheid - Organisatorische eenheid * medewerker - Medewerker

rol__betrokkenestring

URL-referentie naar een betrokkene gerelateerd aan de ZAAK.

rol__omschrijvingGeneriek'adviseur' | 'behandelaar' | 'belanghebbende' | 'beslisser' | 'initiator' | 'klantcontacter' | 'zaakcoordinator' | 'mede_initiator'

Algemeen gehanteerde benaming van de aard van de ROL, afgeleid uit het ROLTYPE.

maximaleVertrouwelijkheidaanduiding'openbaar' | 'beperkt_openbaar' | 'intern' | 'zaakvertrouwelijk' | 'vertrouwelijk' | 'confidentieel' | 'geheim' | 'zeer_geheim'

Zaken met een vertrouwelijkheidaanduiding die beperkter is dan de aangegeven aanduiding worden uit de resultaten gefiltered.

rol__betrokkeneIdentificatie__natuurlijkPersoon__inpBsnstring

Het burgerservicenummer, bedoeld in artikel 1.1 van de Wet algemene bepalingen burgerservicenummer.

rol__betrokkeneIdentificatie__natuurlijkPersoon__anpIdentificatiestring

Het door de gemeente uitgegeven unieke nummer voor een ANDER NATUURLIJK PERSOON

rol__betrokkeneIdentificatie__natuurlijkPersoon__inpA_nummerstring

Het administratienummer van de persoon, bedoeld in de Wet BRP

rol__betrokkeneIdentificatie__nietNatuurlijkPersoon__innNnpIdstring

Het door een kamer toegekend uniek nummer voor de INGESCHREVEN NIET-NATUURLIJK PERSOON

rol__betrokkeneIdentificatie__nietNatuurlijkPersoon__annIdentificatiestring

Het door de gemeente uitgegeven unieke nummer voor een ANDER NIET-NATUURLIJK PERSOON

rol__betrokkeneIdentificatie__vestiging__vestigingsNummerstring

Een korte unieke aanduiding van de Vestiging.

rol__betrokkeneIdentificatie__medewerker__identificatiestring

Een korte unieke aanduiding van de MEDEWERKER.

rol__betrokkeneIdentificatie__organisatorischeEenheid__identificatiestring

Een korte identificatie van de organisatorische eenheid.

expandstring

Gebruik liever het nieuwe field-element voor expand. <br><br>Examples: expand=zaaktype, status, status.statustype, hoofdzaak.status.statustype, hoofdzaak.deelzaken.status.statustype`Haal details van gelinkte resources direct op. Als je meerdere resources tegelijk wilt ophalen kun je deze scheiden met een komma. Voor het ophalen van resources die een laag dieper genest zijn wordt de punt-notatie gebruikt.

ordering'startdatum' | '-startdatum' | 'einddatum' | '-einddatum' | 'publicatiedatum' | '-publicatiedatum' | 'archiefactiedatum' | '-archiefactiedatum' | 'registratiedatum' | '-registratiedatum' | 'identificatie' | '-identificatie'

Het veld waarop de resultaten geordend worden. Het minnetje betekent omgekeerde volgorde.

Example request

{
  "fields": [
    "url",
    "uuid",
    "identificatie",
    "bronorganisatie",
    {
      "zaaktype": [
        "identificatie",
        "omschrijving",
        {
          "catalogus": [
            "domein"
          ]
        }
      ],
      "status": [
        "volgnummer",
        "datumstatusgezet"
      ],
      "resultaat": [
        "*"
      ],
      "zaakinformatieobjecten": [
        {
          "informatieobject": [
            "inhoud",
            "bestandsnaam",
            "bestandsomvang"
          ]
        }
      ],
      "processobject": [
        "identificatie"
      ]
    }
  ],
  "uuid__in": [
    "e80b7507-199a-484c-ad49-c41a1e43a6e7",
    "78e12133-c467-4202-91ba-4417baa52801"
  ],
  "identificatie": "zaak123",
  "bronorganisatie": "000000000",
  "bronorganisatie__in": [
    "000000000",
    "479559740",
    "875883461"
  ],
  "zaaktype": "https://catalogi-api.test.vng.cloud/api/v1/zaaktypen/e80b7507-199a-484c-ad49-c41a1e43a6e7",
  "zaaktype__in": [
    "https://catalogi-api.test.vng.cloud/api/v1/zaaktypen/e80b7507-199a-484c-ad49-c41a1e43a6e7",
    "https://catalogi-api.test.vng.cloud/api/v1/zaaktypen/78e12133-c467-4202-91ba-4417baa52801"
  ],
  "archiefnominatie": "blijvend_bewaren",
  "archiefnominatie__in": [
    "blijvend_bewaren",
    "vernietigen"
  ],
  "archiefactiedatum": "2019-01-02",
  "archiefactiedatum__lt": "2020-01-02",
  "archiefactiedatum__gt": "2018-01-02",
  "archiefstatus": "nog_te_archiveren",
  "archiefstatus__in": [
    "nog_te_archiveren",
    "gearchiveerd",
    "gearchiveerd_procestermijn_onbekend",
    "overgedragen"
  ],
  "startdatum": "2017-01-02",
  "startdatum__gt": "2018-01-02",
  "startdatum__gte": "2016-01-02",
  "startdatum__lt": "2018-01-02",
  "startdatum__lte": "2018-01-02",
  "registratiedatum": "2015-01-02",
  "registratiedatum__gt": "2014-01-02",
  "registratiedatum__lt": "2016-01-02",
  "einddatum": "2022-01-02",
  "einddatum__gt": "2021-01-02",
  "einddatum__lt": "2023-01-02",
  "einddatumGepland": "2022-01-02",
  "einddatumGepland__gt": "2021-01-02",
  "einddatumGepland__lt": "2024-01-02",
  "uiterlijkeEinddatumAfdoening": "2024-01-02",
  "uiterlijkeEinddatumAfdoening__gt": "2023-01-02",
  "uiterlijkeEinddatumAfdoening__lt": "2025-01-02",
  "rol__betrokkeneType": "natuurlijk_persoon",
  "rol__betrokkene": "https://example.com",
  "rol__omschrijvingGeneriek": "initiator",
  "maximaleVertrouwelijkheidaanduiding": "zaakvertrouwelijk",
  "rol__betrokkeneIdentificatie__natuurlijkPersoon__inpBsn": "123456789",
  "rol__betrokkeneIdentificatie__natuurlijkPersoon__anpIdentificatie": "123456789",
  "rol__betrokkeneIdentificatie__natuurlijkPersoon__inpA_nummer": "123456789",
  "rol__betrokkeneIdentificatie__nietNatuurlijkPersoon__innNnpId": "123456789",
  "rol__betrokkeneIdentificatie__nietNatuurlijkPersoon__annIdentificatie": "123456789",
  "rol__betrokkeneIdentificatie__vestiging__vestigingsNummer": "123456789",
  "rol__betrokkeneIdentificatie__medewerker__identificatie": "123456789",
  "rol__betrokkeneIdentificatie__organisatorischeEenheid__identificatie": "123456789",
  "expand": "zaaktype, status, status.statustype, hoofdzaak.status.statustype, hoofdzaak.deelzaken.status.statustype",
  "ordering": "-startdatum"
}

Response

OK

countinteger
nextstring uri nullable
previousstring uri nullable