Flemish Permit Leads (Omgevingsvergunningen)

Turn the official Flemish Omgevingsloket open data into a clean, searchable B2B lead feed of stedenbouwkundige aanvragen (urban-planning applications) and IIOA projects (classified installations and activities): current status, submission date, competent authority, act, project link and optional WGS84 geometry. No portal scraping, no manual dossier work. Ready for a CRM, a map or an AI agent.

This Actor uses only the public MercatorNet WFS 2.0.0 of the Flemish Government. The citizen portal behind an anti-bot wall is not scraped. Subdivision permits (VK codes) are deliberately excluded and remain the domain of the separate Flanders Subdivision Permit Monitor Actor.

When should an AI agent use this?

• "Which new urban-planning applications were filed in Flanders in the last 30 days?"
• "Which environmental projects fall inside a bounding box around Ghent?"
• "Monitor Flemish permit applications and return only new or status-changed projects."
• "Fetch IIOA applications and filter the results client-side on class 1, province Vlaams-Brabant and an active status."

What this Actor does

• Reads the official layers lu:lu_omv_gd_v2 and lu:lu_omv_iioa_v2 without an API key, account or captcha.
• Returns one record per official GD or IIOA source feature with a stable recordKey, project number, project type, current status, status date, submission date, phase, competent authority, act, official project link and IIOA attributes.
• Filters server-side on source layer, project type, status in full mode, competent authority, project numbers, a date window and a geographic bounding box.
• Fetches records oldest-first and stably using keyset pagination: datum_indiening ASC,id ASC for snapshots and datum_huidige_toestand ASC,id ASC for change monitoring. New status updates therefore join the back of the backlog instead of being skipped.
• Distinguishes applications, notifications, amendments, transfers and discontinuations from the official source fields.
• Computes statusGroep, dagenSindsIndiening and a tolerant geometryCenterLat/geometryCenterLon without an external geocoder.
• Offers geometryMode=none, centroid or full: no location, the centre of the geometry bounding box, or the complete WGS84 GeoJSON geometry (Polygon/MultiPolygon).
• Detects new, content-changed and status-changed source features through a monitor-specific named key-value store. changes_only scans on the status date and deliberately drops status filters so decisions are not missed.
• Deduplicates on recordKey (sourceLayer + sourceRecordId, with UUID and project-number fallbacks). Multiple IIOA installations under the same project number are therefore kept.
• Survives feed drift in optional fields: unknown statuses, empty strings, null values and unexpected geometry never crash a run. If the mandatory sort date or id for stable pagination is missing, that layer stops explicitly with an error status.
• Exports no raw applicant or operator names. bedrijfssignaalAanwezig is only a yes/no signal when the source contains a 9/10-digit KBO-like number.

Coverage and scope

On 25 September 2026 the official catalogue reported:

• 786,291 urban-planning projects and notifications in lu:lu_omv_gd_v2;
• 195,332 IIOA projects and notifications in lu:lu_omv_iioa_v2.

The live probe of the last 200 records per layer contained mostly OMV2019_AANVRAAG for GD and applications, notifications, transfers and amendments for IIOA. IIOA class 1, 2 and 3 all occur live.

Subdivision codes are actively excluded. This Actor is therefore a broad non-subdivision feed and not a duplicate of be-verkavelingsvergunningen.

Quick start

Start small: maxResults applies per selected source layer.

1. New applications from the last 30 days:

{
  "mode": "full_snapshot",
  "layers": ["gd", "iioa"],
  "recordTypes": ["application"],
  "lookbackDays": 30,
  "geometryMode": "centroid",
  "maxResults": 10
}

2. Only open IIOA applications with a company signal:

{
  "layers": ["iioa"],
  "recordTypes": ["application"],
  "statuses": [
    "Geen beslissing genomen",
    "In behandeling (in eerste aanleg)",
    "In behandeling (na beroep)"
  ],
  "companySignalOnly": true,
  "geometryMode": "none",
  "maxResults": 25
}

3. Monitor new and changed projects:

{
  "mode": "changes_only",
  "lookbackDays": 90,
  "overlapDays": 2,
  "maxResults": 200
}

Input

Field	Type	Description
mode	select	full_snapshot delivers everything within the filters; changes_only uses the status date, its own monitor cursor and delivers only new, changed or status-changed source features.
layers	multi-select	gd, iioa or both. Default both.
recordTypes	multi-select	application, notification, amendment, transfer or all. Default only application; all cannot be combined with the other options.
statuses	string list	Free source statuses for full_snapshot. Default open statuses; empty means all statuses. In changes_only this filter is ignored so decisions are seen.
authorityContains	string	Substring filter on the competent authority, for example Gent or Provincie Limburg.
companySignalOnly	checkbox	Only records where aanvrager or exploitant contains a 9/10-digit KBO-like number. The identity itself is not exported.
lookbackDays	number	Snapshot: days back on the submission date. First changes run: days back on the status date. Ignored when submissionFrom is set.
submissionFrom / submissionTo	date	submissionFrom uses the submission date in full mode and the status date in changes mode; submissionTo remains a submission-date upper bound.
projectNumbers	string list	One or more numeric project numbers for targeted dossier lookups.
bbox	object	Optional WGS84 box with west, south, east and north.
geometryMode	select	none, centroid (bounding-box centre) or full (GeoJSON outline plus centre).
overlapDays	number	In changes_only, after a fully completed scan per layer, 2 status days are re-checked by default for late corrections.
maxResults	number	1–20,000 per source layer, default 100. After a truncated scan the next run automatically resumes from the keyset cursor.
includeSummary	checkbox	Adds one free summary record.

Output

One JSON record per unique official source feature. Human-readable labels are Flemish (Dutch); as a deliberate technical exception, API keys stay on stable WFS/Apify conventions:

{
  "recordKey": "iioa:id:1025042",
  "sourceLayer": "iioa",
  "sourceLayerName": "IIOA-projecten en meldingen",
  "sourceRecordId": 1025042,
  "projectnummer": "2026100049",
  "voorwerpUuid": "l_QmMjkaSMqmav3wq73Lfw",
  "projectUrl": "https://omgevingsloket.omgeving.vlaanderen.be?project=2026100049",
  "projectTypeCode": "OMV2019_AANVRAAG",
  "projectTypeDescription": "Aanvraag omgevingsproject",
  "projectSoort": "aanvraag",
  "handelingOmschrijving": null,
  "currentStatus": "In behandeling (in eerste aanleg)",
  "statusGroep": "open",
  "datumIndiening": "2026-09-24",
  "datumHuidigeStatus": "2026-09-25",
  "bevoegdeOverheid": "Provincie Vlaams-Brabant",
  "fase": "Eerste Aanleg",
  "bedrijfssignaalAanwezig": true,
  "inrichtingsnummer": "20190830-0036",
  "iioaKlasse": 1,
  "dagenSindsIndiening": 1,
  "geometry": null,
  "geometryCenterLat": 50.872046,
  "geometryCenterLon": 4.461038,
  "bron": "vlaamse-overheid-mercatornet-wfs",
  "opgehaaldOp": "2026-09-25T12:00:00.000Z",
  "changeType": "snapshot"
}

datumHuidigeStatus is the source status date, not a guaranteed decision date. geometryCenterLat/Lon is the bounding-box centre; geometryMode=full adds the complete WGS84 GeoJSON geometry.

Use cases

• B2B lead generation: contractors, architects, installers and advisers follow new construction, renovation and industrial environmental projects.
• Area monitoring: filter with bbox on a region, port, business campus or development area without processing every Flemish dossier.
• CRM updates: schedule weekly changes_only runs and receive only new or changed dossiers.
• IIOA monitoring: fetch installations and filter the results client-side on class 1, 2 or 3, procedural phase and installation number.

Pricing

This Actor uses Apify's Pay-Per-Event (PPE) pricing model:

• Actor Start: $0.00005;
• permit-lead: $0.005 per delivered snapshot record;
• permit-change: $0.01 per new, content-changed or status-changed record.

Duplicate source features, summaries and records that are not written cost nothing. maxResults: 10 with two layers returns 20 records: about $0.10 in full_snapshot or $0.20 in changes_only, plus $0.00005 Actor Start. Check completedLayers, incompleteLayers, layerResults and snapshotCommitted in RUN_SUMMARY.

Legal

• Source: official Flemish open data from Departement Omgeving, served through the MercatorNet Public Download Service.
• Licence/attribution: Flemish Government open data under the model licence for free reuse (Modellicentie voor gratis hergebruik v1.0) — reuse and commercial exploitation are permitted, with attribution as the only condition. Attribution: Bron: Vlaamse Overheid — MercatorNet Publieke Download Service.
• Privacy: aanvrager and exploitant are never exported. Only the derived boolean bedrijfssignaalAanwezig can be delivered; the privacy setting therefore stays conservative.
• Independence: this Actor is not affiliated with or endorsed by the Flemish Government.
• Use: the data is a source indicator, not legal or financial advice. Always verify decisions in the official Omgevingsloket.

FAQ

Q: Are subdivision permits (verkavelingen) included as well? A: No. Project type codes containing VK are excluded. Use the separate Flanders Subdivision Permit Monitor Actor for those.

Q: What is the difference from be-verkavelingsvergunningen? A: That Actor specialises in all subdivision permits and amendments. This Actor delivers the broader GD and IIOA feed without that specialised production.

Q: Is bevoegdeOverheid the same as municipality or province? A: No. It is the authority handling the dossier. Use bbox for a geographic area filter.

Q: What does changes_only do on the first run? A: Without a previous snapshot for the same monitor configuration, recent status updates are delivered as new. Afterwards new status-date values suffice; the current status filter is not applied, so transitions to Vergunning or Weigering stay visible.

Q: Can a change fall outside the window? A: Content corrections without a change of datum_huidige_toestand cannot be detected reliably through this WFS feed; that requires a full scan. If maxResults truncates a layer, the next run does not restart from the beginning but resumes from the stored keyset cursor. The per-layer watermark is only raised once the scan is complete.

Q: Can two runs use the same monitor at the same time? A: No. Avoid overlapping runs for the same filter configuration. Different monitor configurations have separate snapshot keys, but concurrent writes to the same key can overwrite each other.

Q: What does bedrijfssignaalAanwezig mean? A: Only that the source contains a 9/10-digit KBO-like number in aanvrager or exploitant. The name, the number and other identifiers are not exported.

Related Actors

• Flanders Subdivision Permit Monitor — specialised feed for Flemish subdivision permits and amendments.
• NL Vergunningen & Bekendmakingen Leadfeed — Dutch counterpart for combined Dutch permit and announcement leads.

Zoekwoorden: omgevingsvergunning Vlaanderen, omgevingsvergunningen Vlaanderen, Omgevingsloket, stedenbouwkundige vergunning, stedenbouwkundige aanvraag, IIOA, ingedeelde installaties, industriële vergunning, Vlaamse overheid, Vlaamse bedrijfsvergunning, vergunningenmonitor, leadgeneration Vlaanderen, omgevingsaanvraag, melding omgevingsproject, MercatorNet, GeoJSON.

Keywords

flanders, vlaanderen, belgium, environmental permit, omgevingsvergunning, omgevingsloket, urban planning, stedenbouwkundige vergunning, iioa, industrial permit, permit monitor, lead generation, mercatornet, open data, wfs, geojson

Changelog

0.1.0

• Initial release with GD/IIOA coverage, filters, WGS84 geometry and privacy-safe status-date monitoring.