{ "openapi": "3.0.1", "info": { "title": "Flanders Subdivision Permit Monitor (Verkavelingsvergunningen)", "description": "Structured Flanders subdivision permits (verkavelingsvergunningen) from the official Omgevingsloket open data: project number, type, status, dates, competent authority, applicant companies with KBO number and the parcel polygon. Optional change detection.", "version": "0.1", "x-build-id": "vGsK6ZA7INJ7tqeqb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/codeclouds~be-verkavelingsvergunningen/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-codeclouds-be-verkavelingsvergunningen", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/codeclouds~be-verkavelingsvergunningen/runs": { "post": { "operationId": "runs-sync-codeclouds-be-verkavelingsvergunningen", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/codeclouds~be-verkavelingsvergunningen/run-sync": { "post": { "operationId": "run-sync-codeclouds-be-verkavelingsvergunningen", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "mode": { "title": "Modus", "enum": [ "full_snapshot", "changes_only" ], "type": "string", "description": "full_snapshot = lever alle (gefilterde) verkavelingen. changes_only = lever alleen nieuwe of gewijzigde verkavelingen t.o.v. de vorige run (cross-run-vergelijking in een benoemde key-value store; de allereerste run levert alles als 'nieuw'). Let op: changes_only vergelijkt alleen de dossiers die deze run ophaalt (nieuwste eerst, afgekapt op maxResults) — kies maxResults dus ruim genoeg of gebruik een datumfilter.", "default": "full_snapshot" }, "statuses": { "title": "Statussen (leeg = alle)", "type": "array", "description": "Filter op de dossierstatus (`huidige_toestand`). Meerdere keuzes mogelijk. Leeg laten = alle statussen.", "items": { "type": "string", "enum": [ "Geen beslissing genomen", "In behandeling (in eerste aanleg)", "In behandeling (na beroep)", "Stopgezet", "Vergunning", "Weigering" ] }, "default": [] }, "gemeente": { "title": "Gemeente / bevoegde overheid (tekstfilter)", "type": "string", "description": "Substring-filter op de bevoegde overheid, bv. \"Gent\" of \"Brugge\". Dekt hoofdzakelijk lokaal (gemeentelijk) behandelde dossiers. Niet combineerbaar met `provincie`." }, "provincie": { "title": "Provincie (alleen provinciaal behandelde dossiers)", "enum": [ "Antwerpen", "Limburg", "Oost-Vlaanderen", "Vlaams-Brabant", "West-Vlaanderen" ], "type": "string", "description": "Filtert op dossiers behandeld door \"Provincie \". LET OP: dit dekt NIET de gemeentelijk behandelde verkavelingen binnen die provincie. Niet combineerbaar met `gemeente`." }, "aanvragerBevat": { "title": "Aanvrager bevat (bedrijfsnaam zoeken)", "type": "string", "description": "Substring-filter op het aanvragerveld, bv. een bedrijfsnaam (\"PROJECT\", \"GEOTEC\"). Handig voor markt- of concurrentieonderzoek naar wie welke verkaveling aanvroeg." }, "alleenRechtspersonen": { "title": "Alleen dossiers met rechtspersoon-aanvrager", "type": "boolean", "description": "Als aan: alleen dossiers met minstens één bedrijfsaanvrager (met KBO-nummer). Dit is de B2B-leadgen-modus; natuurlijke personen zijn in de bron toch al anoniem.", "default": false }, "laatsteNDagen": { "title": "Alleen laatste N dagen (indiening)", "minimum": 1, "maximum": 3650, "type": "number", "description": "Geheel getal 1-3650: alleen dossiers die in deze periode zijn ingediend (gerekend vanaf de rundatum). Relatief alternatief voor `datumIndieningVanaf`; niet combineerbaar daarmee." }, "datumIndieningVanaf": { "title": "Ingediend vanaf (YYYY-MM-DD)", "type": "string", "description": "Alleen dossiers met een indieningsdatum op of na deze datum. Laat leeg voor alle jaren. Niet combineerbaar met `laatsteNDagen`." }, "datumIndieningTot": { "title": "Ingediend tot en met (YYYY-MM-DD)", "type": "string", "description": "Alleen dossiers met een indieningsdatum op of vóór deze datum. Combineerbaar met `datumIndieningVanaf` voor een periode." }, "geometryMode": { "title": "Geometrie", "enum": [ "none", "centroid", "full" ], "type": "string", "description": "none = geen geometrie (kleinste, snelste output); centroid = alleen het middelpunt (lat/lon); full = volledige perceelcontour (WGS84 GeoJSON MultiPolygon) plus middelpunt.", "default": "full" }, "maxResults": { "title": "Maximaal aantal verkavelingen", "minimum": 1, "maximum": 20000, "type": "number", "description": "Geheel getal 1-20.000: maximum aantal verkavelingen dat deze run wordt geleverd. Bepaalt direct de kosten (per record via Pay Per Event). Begin klein, bv. 10.", "default": 100 }, "includeSamenvatting": { "title": "Samenvattingsrecord toevoegen", "type": "boolean", "description": "Als aan: één extra dataset-item per run met tellingen per status en per bevoegde overheid. Gratis, geen extra event.", "default": false } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }