{
  "openapi": "3.0.1",
  "info": {
    "title": "Flemish Permit Leads (Omgevingsvergunningen)",
    "description": "Monitor official Flemish urban-planning (stedenbouwkundige) and IIOA environmental permit projects from open data: filters, status changes, WGS84 geometry and privacy-safe B2B project leads.",
    "version": "0.1",
    "x-build-id": "4VlaPrQHqr4X94dTm"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/codeclouds~be-flemish-permit-leads/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-codeclouds-be-flemish-permit-leads",
        "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-flemish-permit-leads/runs": {
      "post": {
        "operationId": "runs-sync-codeclouds-be-flemish-permit-leads",
        "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-flemish-permit-leads/run-sync": {
      "post": {
        "operationId": "run-sync-codeclouds-be-flemish-permit-leads",
        "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 levert alle gefilterde projecten. changes_only gebruikt datum_huidige_toestand, een monitor-specifieke snapshot en levert alleen nieuwe, gewijzigde of statusgewijzigde projecten. Als maxResults een scan afkapt, hervat de volgende run automatisch bij de keysetcursor.",
            "default": "full_snapshot"
          },
          "layers": {
            "title": "Bronlagen",
            "type": "array",
            "description": "Selecteer gd voor stedenbouwkundige projecten en iioa voor ingedeelde installaties en activiteiten. Verkavelingen zitten bewust niet in deze actor.",
            "items": {
              "type": "string",
              "enum": [
                "gd",
                "iioa"
              ]
            },
            "default": [
              "gd",
              "iioa"
            ]
          },
          "recordTypes": {
            "title": "Projectsoorten",
            "type": "array",
            "description": "Selecteer application voor aanvragen, notification voor meldingen, amendment voor bijstellingen, transfer voor overdrachten of all voor alle types behalve de permanent uitgesloten VK-verkavelingscodes. Standaard worden alleen aanvragen opgehaald.",
            "items": {
              "type": "string",
              "enum": [
                "application",
                "notification",
                "amendment",
                "transfer",
                "all"
              ]
            },
            "default": [
              "application"
            ]
          },
          "statuses": {
            "title": "Statussen",
            "type": "array",
            "description": "Vrije bronstatussen uit huidige_toestand voor full_snapshot. Standaard worden open dossiers gebruikt; leeg betekent alle statussen. Dit filter wordt bewust genegeerd in changes_only zodat een dossier dat van open naar Vergunning of Weigering gaat niet wordt gemist.",
            "items": {
              "type": "string"
            },
            "default": [
              "Geen beslissing genomen",
              "In behandeling (in eerste aanleg)",
              "In behandeling (na beroep)"
            ]
          },
          "authorityContains": {
            "title": "Bevoegde overheid bevat",
            "type": "string",
            "description": "Optionele substring-filter op vvo_huidige_toestand, bijvoorbeeld Gent, Turnhout of Provincie Limburg. Dit is de bevoegde overheid en niet noodzakelijk de geografische gemeente."
          },
          "companySignalOnly": {
            "title": "Alleen projecten met bedrijfssignaal",
            "type": "boolean",
            "description": "Als aan, worden alleen projecten behouden waarvan aanvrager of exploitant een 9/10-cijferig KBO-achtig nummer bevat. De actor exporteert geen namen, nummers of ruwe persoonsgegevens.",
            "default": false
          },
          "lookbackDays": {
            "title": "Laatste N dagen",
            "minimum": 1,
            "maximum": 3650,
            "type": "number",
            "description": "Voor full_snapshot zoekt de actor standaard 30 dagen terug in datum_indiening. Voor de eerste changes_only-run is dit 30 dagen terug in datum_huidige_toestand.",
            "default": 30
          },
          "submissionFrom": {
            "title": "Startdatum",
            "type": "string",
            "description": "Optionele absolute YYYY-MM-DD-startdatum. In full_snapshot filtert dit op datum_indiening; in changes_only op datum_huidige_toestand. Deze datum heeft voorrang op lookbackDays en de vorige watermark."
          },
          "submissionTo": {
            "title": "Ingediend tot en met",
            "type": "string",
            "description": "Optionele absolute YYYY-MM-DD-einddatum, bijvoorbeeld 2026-09-30."
          },
          "projectNumbers": {
            "title": "Specifieke projectnummers",
            "type": "array",
            "description": "Optionele lijst met numerieke projectnummers, bijvoorbeeld [\"2026088373\", \"2026100049\"]. Leeg laten haalt alle nummers binnen de overige filters op.",
            "items": {
              "type": "string",
              "pattern": "^\\d{4,20}$"
            }
          },
          "bbox": {
            "title": "Geografische bounding box",
            "required": [
              "west",
              "south",
              "east",
              "north"
            ],
            "type": "object",
            "description": "Optionele WGS84-bounding box in decimale graden om alleen projecten binnen een gebied op te halen.",
            "properties": {
              "west": {
                "title": "West",
                "description": "Minimale lengtegraad, bijvoorbeeld 2.5.",
                "type": "number"
              },
              "south": {
                "title": "Zuid",
                "description": "Minimale breedtegraad, bijvoorbeeld 50.5.",
                "type": "number"
              },
              "east": {
                "title": "Oost",
                "description": "Maximale lengtegraad, bijvoorbeeld 5.5.",
                "type": "number"
              },
              "north": {
                "title": "Noord",
                "description": "Maximale breedtegraad, bijvoorbeeld 51.5.",
                "type": "number"
              }
            }
          },
          "geometryMode": {
            "title": "Geometrie",
            "enum": [
              "none",
              "centroid",
              "full"
            ],
            "type": "string",
            "description": "none levert geen geometrie, centroid alleen een afgeleid middelpunt en full de volledige WGS84 GeoJSON-contour plus middelpunt.",
            "default": "centroid"
          },
          "overlapDays": {
            "title": "Overlapdagen voor changes_only",
            "minimum": 0,
            "maximum": 30,
            "type": "number",
            "description": "Bij changes_only wordt vanaf de laatste volledig afgeronde scan per bronlaag standaard twee dagen opnieuw op de statusdatum bekeken. Een eerste run zonder scanstart gebruikt lookbackDays.",
            "default": 2
          },
          "maxResults": {
            "title": "Maximaal aantal projecten",
            "minimum": 1,
            "maximum": 20000,
            "type": "number",
            "description": "Maximum aantal geleverde records per geselecteerde bronlaag. Als de limiet voor het einde van de WFS-scan wordt bereikt, blijft een monitor-specifieke keysetcursor staan en verwerkt de volgende run de resterende backlog.",
            "default": 100
          },
          "includeSummary": {
            "title": "Samenvattingsrecord toevoegen",
            "type": "boolean",
            "description": "Voegt één gratis dataset-item toe met aantallen per laag, projectsoort, status, overheid en bedrijfssignaal.",
            "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}