VNG Realisatie · Schema
ZaakTypeCreate
Set gegevensgroepdata from validated nested data. Usage: include the mixin on the ModelSerializer that has gegevensgroepen.
CompanyGovernmentMunicipalitiesNetherlandsAPI StandardsCommon GroundOpen StandardsPublic Sector
Properties
| Name | Type | Description |
|---|---|---|
| url | string | URL-referentie naar dit object. Dit is de unieke identificatie en locatie van dit object. |
| identificatie | string | Unieke identificatie van het ZAAKTYPE binnen de CATALOGUS waarin het ZAAKTYPE voorkomt. |
| omschrijving | string | Omschrijving van de aard van ZAAKen van het ZAAKTYPE. |
| omschrijvingGeneriek | string | Algemeen gehanteerde omschrijving van de aard van ZAAKen van het ZAAKTYPE |
| vertrouwelijkheidaanduiding | object | Aanduiding van de mate waarin zaakdossiers van ZAAKen van dit ZAAKTYPE voor de openbaarheid bestemd zijn. Indien de zaak bij het aanmaken geen vertrouwelijkheidaanduiding krijgt, dan wordt deze waarde |
| doel | string | Een omschrijving van hetgeen beoogd is te bereiken met een zaak van dit zaaktype. |
| aanleiding | string | Een omschrijving van de gebeurtenis die leidt tot het starten van een ZAAK van dit ZAAKTYPE. |
| toelichting | string | Een eventuele toelichting op dit zaaktype, zoals een beschrijving van het procesverloop op de hoofdlijnen. |
| indicatieInternOfExtern | object | Een aanduiding waarmee onderscheid wordt gemaakt tussen ZAAKTYPEn die Intern respectievelijk Extern geïnitieerd worden. Indien van beide sprake kan zijn, dan prevaleert de externe initiatie. Uitleg bi |
| handelingInitiator | string | Werkwoord dat hoort bij de handeling die de initiator verricht bij dit zaaktype. Meestal 'aanvragen', 'indienen' of 'melden'. Zie ook het IOB model op https://www.gemmaonline.nl/index.php/Imztc_2.1/do |
| onderwerp | string | Het onderwerp van ZAAKen van dit ZAAKTYPE. In veel gevallen nauw gerelateerd aan de product- of dienstnaam uit de Producten- en Dienstencatalogus (PDC). Bijvoorbeeld: 'Evenementenvergunning', 'Geboort |
| handelingBehandelaar | string | Werkwoord dat hoort bij de handeling die de behandelaar verricht bij het afdoen van ZAAKen van dit ZAAKTYPE. Meestal 'behandelen', 'uitvoeren', 'vaststellen' of 'onderhouden'. Zie ook het IOB model op |
| doorlooptijd | string | De periode waarbinnen volgens wet- en regelgeving een ZAAK van het ZAAKTYPE afgerond dient te zijn, in kalenderdagen. |
| servicenorm | stringnull | De periode waarbinnen verwacht wordt dat een ZAAK van het ZAAKTYPE afgerond wordt conform de geldende servicenormen van de zaakbehandelende organisatie(s). |
| opschortingEnAanhoudingMogelijk | boolean | Aanduiding die aangeeft of ZAAKen van dit mogelijk ZAAKTYPE kunnen worden opgeschort en/of aangehouden. |
| verlengingMogelijk | boolean | Aanduiding die aangeeft of de Doorlooptijd behandeling van ZAAKen van dit ZAAKTYPE kan worden verlengd. |
| verlengingstermijn | stringnull | Een tijdsduur in ISO 8601 formaat waarmee de Doorlooptijd behandeling van ZAAKen van dit ZAAKTYPE kan worden verlengd. Mag alleen een waarde bevatten als verlenging mogelijk is. |
| trefwoorden | array | Een trefwoord waarmee ZAAKen van het ZAAKTYPE kunnen worden gekarakteriseerd. |
| publicatieIndicatie | boolean | Aanduiding of (het starten van) een ZAAK dit ZAAKTYPE gepubliceerd moet worden. |
| publicatietekst | string | De generieke tekst van de publicatie van ZAAKen van dit ZAAKTYPE. |
| verantwoordingsrelatie | array | De relatie tussen ZAAKen van dit ZAAKTYPE en de beleidsmatige en/of financiële verantwoording. |
| productenOfDiensten | array | Het product of de dienst die door ZAAKen van dit ZAAKTYPE wordt voortgebracht. |
| selectielijstProcestype | string | URL-referentie naar een vanuit archiveringsoptiek onderkende groep processen met dezelfde kenmerken (PROCESTYPE in de Selectielijst API). |
| referentieproces | object | Het Referentieproces dat ten grondslag ligt aan dit ZAAKTYPE. |
| verantwoordelijke | string | De (soort) organisatorische eenheid of (functie van) medewerker die verantwoordelijk is voor de uitvoering van zaken van het ZAAKTYPE. |
| zaakobjecttypen | array | |
| broncatalogus | object | De CATALOGUS waaraan het ZAAKTYPE is ontleend. |
| bronzaaktype | object | Het zaaktype binnen de CATALOGUS waaraan dit ZAAKTYPE is ontleend. |
| catalogus | string | URL-referentie naar de CATALOGUS waartoe dit ZAAKTYPE behoort. |
| statustypen | array | URL-referenties naar de STATUSTYPEN die mogelijk zijn binnen dit ZAAKTYPE. |
| resultaattypen | array | URL-referenties naar de RESULTAATTYPEN die mogelijk zijn binnen dit ZAAKTYPE. |
| eigenschappen | array | URL-referenties naar de EIGENSCHAPPEN die aanwezig moeten zijn in ZAKEN van dit ZAAKTYPE. |
| informatieobjecttypen | string | |
| roltypen | array | URL-referenties naar de ROLTYPEN die mogelijk zijn binnen dit ZAAKTYPE. |
| besluittypen | array | `Omschrijvingen` van BESLUITTYPEN die mogelijk zijn binnen dit ZAAKTYPE. |
| deelzaaktypen | array | De `zaaktypen.identificaties` waaronder ZAAKen als deelzaak kunnen voorkomen bij ZAAKen van dit ZAAKTYPE. |
| gerelateerdeZaaktypen | array | De ZAAKTYPEn van zaken die relevant zijn voor zaken van dit ZAAKTYPE. |
| beginGeldigheid | string | De datum waarop het is ontstaan. |
| eindeGeldigheid | stringnull | De datum waarop het is opgeheven. |
| beginObject | stringnull | De datum waarop de eerst versie van het object ontstaan is. |
| eindeObject | stringnull | De datum van de aller laatste versie van het object. |
| versiedatum | string | De datum waarop de (gewijzigde) kenmerken van het ZAAKTYPE geldig zijn geworden |
| concept | boolean | Geeft aan of het object een concept betreft. Concepten zijn niet-definitieve versies en zouden niet gebruikt moeten worden buiten deze API. |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://raw.githubusercontent.com/api-evangelist/vng-realisatie/main/json-schema/vng-realisatie-zaak-type-create-schema.json",
"title": "ZaakTypeCreate",
"description": "Set gegevensgroepdata from validated nested data.\n\nUsage: include the mixin on the ModelSerializer that has gegevensgroepen.",
"x-generated": "2026-10-09",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/vng-realisatie-catalogi-openapi.yml#/components/schemas/ZaakTypeCreate",
"type": "object",
"properties": {
"url": {
"type": "string",
"format": "uri",
"readOnly": true,
"title": "url",
"description": "URL-referentie naar dit object. Dit is de unieke identificatie en locatie van dit object.",
"minLength": 1,
"maxLength": 1000
},
"identificatie": {
"type": "string",
"description": "Unieke identificatie van het ZAAKTYPE binnen de CATALOGUS waarin het ZAAKTYPE voorkomt.",
"title": "identificatie",
"maxLength": 50
},
"omschrijving": {
"type": "string",
"description": "Omschrijving van de aard van ZAAKen van het ZAAKTYPE.",
"title": "omschrijving",
"maxLength": 80
},
"omschrijvingGeneriek": {
"type": "string",
"description": "Algemeen gehanteerde omschrijving van de aard van ZAAKen van het ZAAKTYPE",
"title": "omschrijving generiek",
"maxLength": 80
},
"vertrouwelijkheidaanduiding": {
"allOf": [
{
"$ref": "#/$defs/VertrouwelijkheidaanduidingEnum"
}
],
"description": "Aanduiding van de mate waarin zaakdossiers van ZAAKen van dit ZAAKTYPE voor de openbaarheid bestemd zijn. Indien de zaak bij het aanmaken geen vertrouwelijkheidaanduiding krijgt, dan wordt deze waarde gezet.\n\nUitleg bij mogelijke waarden:\n\n* `openbaar` - Openbaar\n* `beperkt_openbaar` - Beperkt openbaar\n* `intern` - Intern\n* `zaakvertrouwelijk` - Zaakvertrouwelijk\n* `vertrouwelijk` - Vertrouwelijk\n* `confidentieel` - Confidentieel\n* `geheim` - Geheim\n* `zeer_geheim` - Zeer geheim",
"title": "vertrouwelijkheidaanduiding"
},
"doel": {
"type": "string",
"description": "Een omschrijving van hetgeen beoogd is te bereiken met een zaak van dit zaaktype.",
"title": "doel"
},
"aanleiding": {
"type": "string",
"description": "Een omschrijving van de gebeurtenis die leidt tot het starten van een ZAAK van dit ZAAKTYPE.",
"title": "aanleiding"
},
"toelichting": {
"type": "string",
"description": "Een eventuele toelichting op dit zaaktype, zoals een beschrijving van het procesverloop op de hoofdlijnen.",
"title": "toelichting"
},
"indicatieInternOfExtern": {
"allOf": [
{
"$ref": "#/$defs/IndicatieInternOfExternEnum"
}
],
"description": "Een aanduiding waarmee onderscheid wordt gemaakt tussen ZAAKTYPEn die Intern respectievelijk Extern geïnitieerd worden. Indien van beide sprake kan zijn, dan prevaleert de externe initiatie.\n\nUitleg bij mogelijke waarden:\n\n* `inkomend` - Inkomend\n* `intern` - Intern\n* `uitgaand` - Uitgaand",
"title": "indicatie intern of extern"
},
"handelingInitiator": {
"type": "string",
"description": "Werkwoord dat hoort bij de handeling die de initiator verricht bij dit zaaktype. Meestal 'aanvragen', 'indienen' of 'melden'. Zie ook het IOB model op https://www.gemmaonline.nl/index.php/Imztc_2.1/doc/attribuutsoort/zaaktype.handeling_initiator",
"title": "handeling initiator",
"maxLength": 20
},
"onderwerp": {
"type": "string",
"description": "Het onderwerp van ZAAKen van dit ZAAKTYPE. In veel gevallen nauw gerelateerd aan de product- of dienstnaam uit de Producten- en Dienstencatalogus (PDC). Bijvoorbeeld: 'Evenementenvergunning', 'Geboorte', 'Klacht'. Zie ook het IOB model op https://www.gemmaonline.nl/index.php/Imztc_2.1/doc/attribuutsoort/zaaktype.onderwerp",
"title": "onderwerp",
"maxLength": 80
},
"handelingBehandelaar": {
"type": "string",
"description": "Werkwoord dat hoort bij de handeling die de behandelaar verricht bij het afdoen van ZAAKen van dit ZAAKTYPE. Meestal 'behandelen', 'uitvoeren', 'vaststellen' of 'onderhouden'. Zie ook het IOB model op https://www.gemmaonline.nl/index.php/Imztc_2.1/doc/attribuutsoort/zaaktype.handeling_behandelaar",
"title": "handeling behandelaar",
"maxLength": 20
},
"doorlooptijd": {
"type": "string",
"description": "De periode waarbinnen volgens wet- en regelgeving een ZAAK van het ZAAKTYPE afgerond dient te zijn, in kalenderdagen.",
"title": "doorlooptijd behandeling",
"format": "duration"
},
"servicenorm": {
"type": [
"string",
"null"
],
"description": "De periode waarbinnen verwacht wordt dat een ZAAK van het ZAAKTYPE afgerond wordt conform de geldende servicenormen van de zaakbehandelende organisatie(s).",
"title": "servicenorm behandeling",
"format": "duration"
},
"opschortingEnAanhoudingMogelijk": {
"type": "boolean",
"title": "Opschorting/aanhouding mogelijk",
"description": "Aanduiding die aangeeft of ZAAKen van dit mogelijk ZAAKTYPE kunnen worden opgeschort en/of aangehouden."
},
"verlengingMogelijk": {
"type": "boolean",
"description": "Aanduiding die aangeeft of de Doorlooptijd behandeling van ZAAKen van dit ZAAKTYPE kan worden verlengd.",
"title": "verlenging mogelijk"
},
"verlengingstermijn": {
"type": [
"string",
"null"
],
"description": "Een tijdsduur in ISO 8601 formaat waarmee de Doorlooptijd behandeling van ZAAKen van dit ZAAKTYPE kan worden verlengd. Mag alleen een waarde bevatten als verlenging mogelijk is.",
"title": "verlengingstermijn",
"format": "duration"
},
"trefwoorden": {
"type": "array",
"items": {
"type": "string",
"title": "Trefwoord",
"maxLength": 30
},
"description": "Een trefwoord waarmee ZAAKen van het ZAAKTYPE kunnen worden gekarakteriseerd.",
"title": "trefwoorden"
},
"publicatieIndicatie": {
"type": "boolean",
"description": "Aanduiding of (het starten van) een ZAAK dit ZAAKTYPE gepubliceerd moet worden.",
"title": "publicatie indicatie"
},
"publicatietekst": {
"type": "string",
"description": "De generieke tekst van de publicatie van ZAAKen van dit ZAAKTYPE.",
"title": "publicatietekst"
},
"verantwoordingsrelatie": {
"type": "array",
"items": {
"type": "string",
"maxLength": 40
},
"description": "De relatie tussen ZAAKen van dit ZAAKTYPE en de beleidsmatige en/of financiële verantwoording.",
"title": "verantwoordingsrelatie"
},
"productenOfDiensten": {
"type": "array",
"items": {
"type": "string",
"format": "uri",
"title": "URL naar product/dienst",
"maxLength": 1000
},
"description": "Het product of de dienst die door ZAAKen van dit ZAAKTYPE wordt voortgebracht.",
"title": "producten of diensten"
},
"selectielijstProcestype": {
"type": "string",
"format": "uri",
"description": "URL-referentie naar een vanuit archiveringsoptiek onderkende groep processen met dezelfde kenmerken (PROCESTYPE in de Selectielijst API).",
"title": "selectielijst procestype",
"maxLength": 200
},
"referentieproces": {
"allOf": [
{
"$ref": "#/$defs/ReferentieProces"
}
],
"description": "Het Referentieproces dat ten grondslag ligt aan dit ZAAKTYPE.",
"title": "referentieproces"
},
"verantwoordelijke": {
"type": "string",
"description": "De (soort) organisatorische eenheid of (functie van) medewerker die verantwoordelijk is voor de uitvoering van zaken van het ZAAKTYPE.",
"title": "verantwoordelijke",
"maxLength": 50
},
"zaakobjecttypen": {
"type": "array",
"items": {
"type": "string",
"format": "uri",
"title": ""
},
"readOnly": true,
"title": "Zaaktype",
"uniqueItems": true
},
"broncatalogus": {
"allOf": [
{
"$ref": "#/$defs/BronCatalogus"
}
],
"description": "De CATALOGUS waaraan het ZAAKTYPE is ontleend.",
"title": "broncatalogus"
},
"bronzaaktype": {
"allOf": [
{
"$ref": "#/$defs/BronZaaktype"
}
],
"description": "Het zaaktype binnen de CATALOGUS waaraan dit ZAAKTYPE is ontleend.",
"title": "bronzaaktype"
},
"catalogus": {
"type": "string",
"format": "uri",
"description": "URL-referentie naar de CATALOGUS waartoe dit ZAAKTYPE behoort.",
"title": "Catalogus"
},
"statustypen": {
"type": "array",
"items": {
"type": "string",
"format": "uri",
"title": ""
},
"readOnly": true,
"description": "URL-referenties naar de STATUSTYPEN die mogelijk zijn binnen dit ZAAKTYPE.",
"title": "Zaaktype",
"uniqueItems": true
},
"resultaattypen": {
"type": "array",
"items": {
"type": "string",
"format": "uri",
"title": ""
},
"readOnly": true,
"description": "URL-referenties naar de RESULTAATTYPEN die mogelijk zijn binnen dit ZAAKTYPE.",
"title": "is relevant voor",
"uniqueItems": true
},
"eigenschappen": {
"type": "array",
"items": {
"type": "string",
"format": "uri",
"title": ""
},
"readOnly": true,
"description": "URL-referenties naar de EIGENSCHAPPEN die aanwezig moeten zijn in ZAKEN van dit ZAAKTYPE.",
"title": "Zaaktype",
"uniqueItems": true
},
"informatieobjecttypen": {
"type": "string",
"readOnly": true,
"title": "informatieobjecttypen"
},
"roltypen": {
"type": "array",
"items": {
"type": "string",
"format": "uri",
"title": ""
},
"readOnly": true,
"description": "URL-referenties naar de ROLTYPEN die mogelijk zijn binnen dit ZAAKTYPE.",
"title": "Zaaktype",
"uniqueItems": true
},
"besluittypen": {
"type": "array",
"items": {
"type": "string",
"title": ""
},
"description": "`Omschrijvingen` van BESLUITTYPEN die mogelijk zijn binnen dit ZAAKTYPE.",
"title": "zaaktypen"
},
"deelzaaktypen": {
"type": "array",
"items": {
"type": "string",
"title": ""
},
"description": "De `zaaktypen.identificaties` waaronder ZAAKen als deelzaak kunnen voorkomen bij ZAAKen van dit ZAAKTYPE.",
"title": "deelzaaktypen"
},
"gerelateerdeZaaktypen": {
"type": "array",
"items": {
"$ref": "#/$defs/ZaakTypenRelatieCreate"
},
"description": "De ZAAKTYPEn van zaken die relevant zijn voor zaken van dit ZAAKTYPE.",
"title": "zaaktype van"
},
"beginGeldigheid": {
"type": "string",
"format": "date",
"description": "De datum waarop het is ontstaan.",
"title": "datum begin geldigheid"
},
"eindeGeldigheid": {
"type": [
"string",
"null"
],
"format": "date",
"description": "De datum waarop het is opgeheven.",
"title": "datum einde geldigheid"
},
"beginObject": {
"type": [
"string",
"null"
],
"format": "date",
"description": "De datum waarop de eerst versie van het object ontstaan is.",
"title": "datum begin object"
},
"eindeObject": {
"type": [
"string",
"null"
],
"format": "date",
"description": "De datum van de aller laatste versie van het object.",
"title": "datum einde object"
},
"versiedatum": {
"type": "string",
"format": "date",
"description": "De datum waarop de (gewijzigde) kenmerken van het ZAAKTYPE geldig zijn geworden",
"title": "versiedatum"
},
"concept": {
"type": "boolean",
"readOnly": true,
"description": "Geeft aan of het object een concept betreft. Concepten zijn niet-definitieve versies en zouden niet gebruikt moeten worden buiten deze API.",
"title": "concept"
}
},
"required": [
"aanleiding",
"beginGeldigheid",
"besluittypen",
"catalogus",
"concept",
"deelzaaktypen",
"doel",
"doorlooptijd",
"eigenschappen",
"gerelateerdeZaaktypen",
"handelingBehandelaar",
"handelingInitiator",
"identificatie",
"indicatieInternOfExtern",
"informatieobjecttypen",
"omschrijving",
"onderwerp",
"opschortingEnAanhoudingMogelijk",
"productenOfDiensten",
"publicatieIndicatie",
"referentieproces",
"resultaattypen",
"roltypen",
"statustypen",
"url",
"verantwoordelijke",
"verlengingMogelijk",
"versiedatum",
"vertrouwelijkheidaanduiding",
"zaakobjecttypen"
],
"$defs": {
"AardRelatieEnum": {
"enum": [
"vervolg",
"bijdrage",
"onderwerp"
],
"type": "string"
},
"BronCatalogus": {
"type": "object",
"description": "De CATALOGUS waaraan het ZAAKTYPE is ontleend.",
"properties": {
"url": {
"type": "string",
"format": "uri",
"title": "URL-referentie broncatalogus",
"maxLength": 200
},
"domein": {
"type": "string",
"description": "Het domein van de CATALOGUS waaraan het ZAAKTYPE is ontleend.",
"title": "broncatalogus domein",
"maxLength": 5
},
"rsin": {
"type": "string",
"description": "Het RSIN van de INGESCHREVEN NIET-NATUURLIJK PERSOON die beheerder is van de CATALOGUS waaraan het ZAAKTYPE is ontleend.",
"title": "broncatalogus rsin",
"maxLength": 9
}
},
"required": [
"domein",
"rsin",
"url"
]
},
"BronZaaktype": {
"type": "object",
"description": "Het zaaktype binnen de CATALOGUS waaraan dit ZAAKTYPE is ontleend.",
"properties": {
"url": {
"type": "string",
"format": "uri",
"title": "URL-referentie bronzaaktype",
"maxLength": 200
},
"identificatie": {
"type": "string",
"description": "De Zaaktype-identificatie van het bronzaaktype binnen de CATALOGUS.",
"title": "bronzaaktype identificatie",
"maxLength": 50
},
"omschrijving": {
"type": "string",
"description": "De Zaaktype-omschrijving van het bronzaaktype, zoals gehanteerd in de Broncatalogus.",
"title": "bronzaaktype omschrijving",
"maxLength": 80
}
},
"required": [
"identificatie",
"omschrijving",
"url"
]
},
"IndicatieInternOfExternEnum": {
"enum": [
"intern",
"extern"
],
"type": "string"
},
"ReferentieProces": {
"type": "object",
"description": "Het Referentieproces dat ten grondslag ligt aan dit ZAAKTYPE.",
"properties": {
"naam": {
"type": "string",
"title": "Referentieprocesnaam",
"description": "De naam van het Referentieproces.",
"maxLength": 80
},
"link": {
"type": "string",
"format": "uri",
"title": "Referentieproceslink",
"description": "De URL naar de beschrijving van het Referentieproces",
"maxLength": 200
}
},
"required": [
"naam"
]
},
"VertrouwelijkheidaanduidingEnum": {
"enum": [
"openbaar",
"beperkt_openbaar",
"intern",
"zaakvertrouwelijk",
"vertrouwelijk",
"confidentieel",
"geheim",
"zeer_geheim"
],
"type": "string"
},
"ZaakTypenRelatieCreate": {
"type": "object",
"properties": {
"zaaktype": {
"type": "string",
"description": "`zaaktype.identificatie` naar het ZAAKTYPE.",
"title": "zaaktype van"
},
"aardRelatie": {
"allOf": [
{
"$ref": "#/$defs/AardRelatieEnum"
}
],
"description": "Omschrijving van de aard van de relatie van zaken van het ZAAKTYPE tot zaken van het andere ZAAKTYPE\n\nUitleg bij mogelijke waarden:\n\n* `vervolg` - Vervolg\n* `bijdrage` - Bijdrage\n* `onderwerp` - Onderwerp",
"title": "aard relatie"
},
"toelichting": {
"type": "string",
"description": "Een toelichting op de aard van de relatie tussen beide ZAAKTYPEN.",
"title": "toelichting",
"maxLength": 255
}
},
"required": [
"aardRelatie",
"zaaktype"
]
}
}
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/vng-realisatie-zaak-type-create"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.