---
title: "Alle VERZENDINGen opvragen."
method: GET
path: "/verzendingen"
tags: ["verzendingen"]
---

# Alle VERZENDINGen opvragen.

`GET /verzendingen`

Deze lijst kan gefilterd wordt met query-string parameters.

## Query parameters

- `aardRelatie` 'afzender' | 'geadresseerde'
- `informatieobject` string, uri
- `betrokkene` string, uri
- `expand` string
- `page` integer

## Response `200`

OK

- PaginatedVerzendingList
  - `count` integer
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` VerzendingExpanded[]
    - `url` string, uri, required — URL-referentie naar dit object. Dit is de unieke identificatie en locatie van dit object.
    - `betrokkene` string, uri, required — URL-referentie naar de betrokkene waarvan het informatieobject is ontvangen of waaraan dit is verzonden.
    - `informatieobject` string, uri, required — URL-referentie naar het informatieobject dat is ontvangen of verzonden.
    - `aardRelatie` 'afzender' | 'geadresseerde', required
    - `toelichting` string — Verduidelijking van de afzender- of geadresseerde-relatie.
    - `ontvangstdatum` string, date, nullable — <b>DEPRECATED</b> Dit attribuut is verplaatst naar resource Verzending. De datum waarop het INFORMATIEOBJECT ontvangen is. Verplicht te registreren voor INFORMATIEOBJECTen die van buiten de zaakbehandelende organisatie(s) ontvangen zijn. Ontvangst en verzending is voorbehouden aan documenten die van of naar andere personen ontvangen of verzonden zijn waarbij die personen niet deel uit maken van de behandeling van de zaak waarin het document een rol speelt. Vervangt het gelijknamige attribuut uit Informatieobject. Verplicht gevuld wanneer aardRelatie de waarde 'afzender' heeft.
    - `verzenddatum` string, date, nullable — <b>DEPRECATED</b> Dit attribuut is verplaatst naar resource Verzending. De datum waarop het INFORMATIEOBJECT verzonden is, zoals deze op het INFORMATIEOBJECT vermeld is. Dit geldt voor zowel inkomende als uitgaande INFORMATIEOBJECTen. Eenzelfde informatieobject kan niet tegelijk inkomend en uitgaand zijn. Ontvangst en verzending is voorbehouden aan documenten die van of naar andere personen ontvangen of verzonden zijn waarbij die personen niet deel uit maken van de behandeling van de zaak waarin het document een rol speelt. Vervangt het gelijknamige attribuut uit Informatieobject. Verplicht gevuld wanneer aardRelatie de waarde 'geadresseerde' heeft.
    - `contactPersoon` string, uri, required — URL-referentie naar de persoon die als aanspreekpunt fungeert voor de BETROKKENE inzake het ontvangen of verzonden INFORMATIEOBJECT.
    - `contactpersoonnaam` string — De opgemaakte naam van de persoon die als aanspreekpunt fungeert voorde BETROKKENE inzake het ontvangen of verzonden INFORMATIEOBJECT.
    - `binnenlandsCorrespondentieadres` BinnenlandsCorrespondentieadresVerzending, nullable — Het correspondentieadres, betreffende een adresseerbaar object, van de BETROKKENE, zijnde afzender of geadresseerde, zoals vermeld in het ontvangen of verzonden INFORMATIEOBJECT indien dat afwijkt van het reguliere binnenlandse correspondentieadres van BETROKKENE.
      - `huisletter` string — Een door of namens het bevoegd gemeentelijk orgaan ten aanzien van een adresseerbaar object toegekende toevoeging aan een huisnummer in de vorm van een alfanumeriek teken.
      - `huisnummer` integer, required — Een door of namens het bevoegd gemeentelijk orgaan ten aanzien van een adresseerbaar object toegekende nummering.
      - `huisnummerToevoeging` string — Een door of namens het bevoegd gemeentelijk orgaan ten aanzien van een adresseerbaar object toegekende nadere toevoeging aan een huisnummer of een combinatie van huisnummer en huisletter.
      - `naamOpenbareRuimte` string, required — Een door het bevoegde gemeentelijke orgaan aan een GEMEENTELIJKE OPENBARE RUIMTE toegekende benaming.
      - `postcode` string — De door TNT Post vastgestelde code behorende bij een bepaalde combinatie van een naam van een woonplaats, naam van een openbare ruimte en een huisnummer.
      - `woonplaatsnaam` string, required — De door het bevoegde gemeentelijke orgaan aan een WOONPLAATS toegekende benaming.
    - `buitenlandsCorrespondentieadres` BuitenlandsCorrespondentieadresVerzending, nullable — De gegevens van het adres in het buitenland van BETROKKENE, zijnde afzender of geadresseerde, zoals vermeld in het ontvangen of verzonden INFORMATIEOBJECT en dat afwijkt van de reguliere correspondentiegegevens van BETROKKENE.
      - `adresBuitenland1` string, required — Het eerste deel dat behoort bij het afwijkend buitenlandse correspondentieadres van de betrokkene in zijn/haar rol bij de zaak.
      - `adresBuitenland2` string — Het tweede deel dat behoort bij het afwijkend buitenlandse correspondentieadres van de betrokkene in zijn/haar rol bij de zaak.
      - `adresBuitenland3` string — Het derde deel dat behoort bij het afwijkend buitenlandse correspondentieadres van de betrokkene in zijn/haar rol bij de zaak.
      - `landPostadres` string, uri, required — Het LAND dat behoort bij het afwijkend buitenlandse correspondentieadres van de betrokkene in zijn/haar rol bij de zaak.
    - `correspondentiePostadres` BuitenlandsCorrespondentiepostadresVerzending, nullable — De gegevens die tezamen een postbusadres of antwoordnummeradres vormen van BETROKKENE, zijnde afzender of geadresseerde, zoals vermeld in het ontvangen of verzonden INFORMATIEOBJECT en dat afwijkt van de reguliere correspondentiegegevens van BETROKKENE.
      - `postBusOfAntwoordnummer` integer, required — De numerieke aanduiding zoals deze door de Nederlandse PTT is vastgesteld voor postbusadressen en antwoordnummeradressen.
      - `postadresPostcode` string, required — De officiële Nederlandse PTT codering, bestaande uit een numerieke woonplaatscode en een alfabetische lettercode.
      - `postadresType` 'antwoordnummer' | 'postbusnummer', required
      - `woonplaatsnaam` string, required — De door het bevoegde gemeentelijke orgaan aan een WOONPLAATS toegekende benaming.
    - `faxnummer` string, nullable — faxnummer van de ontvanger of afzender.
    - `emailadres` string, nullable — emailadres van de ontvanger of afzender.
    - `mijnOverheid` boolean — is het informatieobject verzonden via mijnOverheid naar de ontvanger.
    - `telefoonnummer` string, nullable — telefoonnummer van de ontvanger of afzender.
    - `_expand` VerzendingEmbedded
      - `informatieobject` EnkelvoudigInformatieObject — Serializer for the EnkelvoudigInformatieObject model
        - `url` string, uri, required — URL-referentie naar dit object. Dit is de unieke identificatie en locatie van dit object.
        - `identificatie` string — Een binnen een gegeven context ondubbelzinnige referentie naar het INFORMATIEOBJECT.
        - `bronorganisatie` string, required — Het RSIN van de Niet-natuurlijk persoon zijnde de organisatie die het informatieobject heeft gecreëerd of heeft ontvangen en als eerste in een samenwerkingsketen heeft vastgelegd.
        - `creatiedatum` string, date, required — Een datum of een gebeurtenis in de levenscyclus van het INFORMATIEOBJECT.
        - `titel` string, required — De naam waaronder het INFORMATIEOBJECT formeel bekend is.
        - `vertrouwelijkheidaanduiding` union — Aanduiding van de mate waarin het INFORMATIEOBJECT voor de openbaarheid bestemd is. Uitleg bij mogelijke waarden: * `openbaar` - Openbaar * `beperkt_openbaar` - Beperkt openbaar * `intern` - Intern * `zaakvertrouwelijk` - Zaakvertrouwelijk * `vertrouwelijk` - Vertrouwelijk * `confidentieel` - Confidentieel * `geheim` - Geheim * `zeer_geheim` - Zeer geheim
          - 'openbaar' | 'beperkt_openbaar' | 'intern' | 'zaakvertrouwelijk' | 'vertrouwelijk' | 'confidentieel' | 'geheim' | 'zeer_geheim'
          - ''
        - `auteur` string, required — De persoon of organisatie die in de eerste plaats verantwoordelijk is voor het creëren van de inhoud van het INFORMATIEOBJECT.
        - `status` union — Aanduiding van de stand van zaken van een INFORMATIEOBJECT. De waarden 'in bewerking' en 'ter vaststelling' komen niet voor als het attribuut `ontvangstdatum` van een waarde is voorzien. Wijziging van de Status in 'gearchiveerd' impliceert dat het informatieobject een duurzaam, niet-wijzigbaar Formaat dient te hebben. Uitleg bij mogelijke waarden: * `in_bewerking` - (In bewerking) Aan het informatieobject wordt nog gewerkt. * `ter_vaststelling` - (Ter vaststelling) Informatieobject gereed maar moet nog vastgesteld worden. * `definitief` - (Definitief) Informatieobject door bevoegd iets of iemand vastgesteld dan wel ontvangen. * `gearchiveerd` - (Gearchiveerd) Informatieobject duurzaam bewaarbaar gemaakt; een gearchiveerd informatie-element.
          - 'in_bewerking' | 'ter_vaststelling' | 'definitief' | 'gearchiveerd'
          - ''
        - `formaat` string — Het "Media Type" (voorheen "MIME type") voor de wijze waaropde inhoud van het INFORMATIEOBJECT is vastgelegd in een computerbestand. Voorbeeld: `application/msword`. Zie: https://www.iana.org/assignments/media-types/media-types.xhtml
        - `taal` string, required — Een ISO 639-2/B taalcode waarin de inhoud van het INFORMATIEOBJECT is vastgelegd. Voorbeeld: `dut`. Zie: https://www.iso.org/standard/4767.html
        - `versie` integer, required — Het (automatische) versienummer van het INFORMATIEOBJECT. Deze begint bij 1 als het INFORMATIEOBJECT aangemaakt wordt.
        - `beginRegistratie` string, date-time, required — Een datumtijd in ISO8601 formaat waarop deze versie van het INFORMATIEOBJECT is aangemaakt of gewijzigd.
        - `bestandsnaam` string — De naam van het fysieke bestand waarin de inhoud van het informatieobject is vastgelegd, inclusief extensie.
        - `inhoud` string, uri, nullable — Download URL van de binaire inhoud.
        - `bestandsomvang` integer, nullable — Aantal bytes dat de inhoud van INFORMATIEOBJECT in beslag neemt.
        - `link` string, uri — De URL waarmee de inhoud van het INFORMATIEOBJECT op te vragen is.
        - `beschrijving` string — Een generieke beschrijving van de inhoud van het INFORMATIEOBJECT.
        - `ontvangstdatum` string, date, nullable — <b>DEPRECATED</b> Dit attribuut is verplaatst naar resource Verzending. De datum waarop het INFORMATIEOBJECT ontvangen is. Verplicht te registreren voor INFORMATIEOBJECTen die van buiten de zaakbehandelende organisatie(s) ontvangen zijn. Ontvangst en verzending is voorbehouden aan documenten die van of naar andere personen ontvangen of verzonden zijn waarbij die personen niet deel uit maken van de behandeling van de zaak waarin het document een rol speelt.
        - `verzenddatum` string, date, nullable — <b>DEPRECATED</b> Dit attribuut is verplaatst naar resource Verzending. De datum waarop het INFORMATIEOBJECT verzonden is, zoals deze op het INFORMATIEOBJECT vermeld is. Dit geldt voor zowel inkomende als uitgaande INFORMATIEOBJECTen. Eenzelfde informatieobject kan niet tegelijk inkomend en uitgaand zijn. Ontvangst en verzending is voorbehouden aan documenten die van of naar andere personen ontvangen of verzonden zijn waarbij die personen niet deel uit maken van de behandeling van de zaak waarin het document een rol speelt.
        - `indicatieGebruiksrecht` boolean, nullable — Indicatie of er beperkingen gelden aangaande het gebruik van het informatieobject anders dan raadpleging. Dit veld mag `null` zijn om aan te geven dat de indicatie nog niet bekend is. Als de indicatie gezet is, dan kan je de gebruiksrechten die van toepassing zijn raadplegen via de GEBRUIKSRECHTen resource.
        - `verschijningsvorm` string — De essentiële opmaakaspecten van een INFORMATIEOBJECT.
        - `ondertekening` Ondertekening, nullable — Aanduiding van de rechtskracht van een informatieobject. Mag niet van een waarde zijn voorzien als de `status` de waarde 'in bewerking' of 'ter vaststelling' heeft.
          - `soort` 'analoog' | 'digitaal' | 'pki', required
          - `datum` string, date, required — De datum waarop de ondertekening van het INFORMATIEOBJECT heeft plaatsgevonden.
        - `integriteit` Integriteit, nullable — Uitdrukking van mate van volledigheid en onbeschadigd zijn van digitaal bestand.
          - `algoritme` 'crc_16' | 'crc_32' | 'crc_64' | 'fletcher_4' | 'fletcher_8' | 'fletcher_16' | 'fletcher_32' | 'hmac' | 'md5' | 'sha_1' | 'sha_256' | 'sha_512' | 'sha_3', required
          - `waarde` string, required — De waarde van de checksum.
          - `datum` string, date, required — Datum waarop de checksum is gemaakt.
        - `informatieobjecttype` string, uri, required — URL-referentie naar het INFORMATIEOBJECTTYPE (in de Catalogi API).
        - `locked` boolean, required — Geeft aan of het document gelocked is. Alleen als een document gelocked is, mogen er aanpassingen gemaakt worden.
        - `bestandsdelen` BestandsDeel[], required
          - `url` string, uri, required — URL-referentie naar dit object. Dit is de unieke identificatie en locatie van dit object.
          - `volgnummer` integer, required — Een volgnummer dat de volgorde van de bestandsdelen aangeeft.
          - `omvang` integer, required — De grootte van dit specifieke bestandsdeel.
          - `voltooid` boolean, required — Indicatie of dit bestandsdeel volledig is geupload. Dat wil zeggen: het aantal bytes dat staat genoemd bij grootte is daadwerkelijk ontvangen.
        - `trefwoorden` string[] — Een lijst van één of meer trefwoorden.

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `406` — Not acceptable
- `409` — Conflict
- `410` — Gone
- `415` — Unsupported media type
- `429` — Too many requests
- `500` — Internal server error

---

[API](https://skmtc.net/vng-realisatie/apis/documenten-api.md) · [All operations](https://skmtc.net/vng-realisatie/apis/documenten-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vng-realisatie/documenten-api/revisions/3898a1454def/schema)