KOOP Official Publications and Regulations

Method	Path	Description	Cost
GET	/sru	Search official Dutch notices by title, publishing authority and publication date; retrieve an identified notice. Includes historical applications and decisions. An application is not an issued permit. One bounded page per purchase.	$0.10 default	View details
GET	/sru/Search	Search CVDR local and BWB national regulation titles	$0.10 default	View details

GET/sru

$0.10 default

Description

Search official Dutch notices by title, publishing authority and publication date; retrieve an identified notice. Includes historical applications and decisions. An application is not an issued permit. One bounded page per purchase.

Documentation

Pricing

$0.10 default

Parameters

{
  "properties": {
    "authority": {
      "description": "Exact publishing authority, e.g. Amsterdam.",
      "maxLength": 200,
      "minLength": 1,
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "from": {
      "description": "Inclusive publication date from, YYYY-MM-DD.",
      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "journal": {
      "description": "Official publication journal",
      "enum": [
        "Staatscourant"
      ],
      "maxLength": 200,
      "minLength": 1,
      "type": "string",
      "x-parameter-location": "query"
    },
    "limit": {
      "default": 10,
      "maximum": 25,
      "minimum": 1,
      "type": "integer",
      "x-parameter-location": "query"
    },
    "publication_id": {
      "description": "Exact official publication identifier from a search result, e.g. gmb-2026-427235.",
      "pattern": "^[A-Za-z0-9-]{1,100}$",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "q": {
      "description": "Literal Dutch words to match in an official publication title. Not a CQL expression.",
      "maxLength": 200,
      "minLength": 1,
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "start": {
      "description": "One-based start record from next_start in a saved KOOP page.",
      "maximum": 100000,
      "minimum": 1,
      "required": false,
      "type": "integer",
      "x-parameter-location": "query"
    },
    "until": {
      "description": "Inclusive publication date until, YYYY-MM-DD.",
      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "type": "object"
}

Response schema

{
  "properties": {
    "coverage": {
      "properties": {
        "complete": {
          "type": "boolean"
        },
        "scope": {
          "type": "string"
        }
      },
      "required": [
        "complete",
        "scope"
      ],
      "type": "object"
    },
    "items": {
      "items": {
        "type": "object"
      },
      "type": "array"
    },
    "notice": {
      "type": "string"
    },
    "source_url": {
      "type": "string"
    }
  },
  "required": [
    "items",
    "coverage",
    "notice",
    "source_url"
  ],
  "type": "object"
}

Example request

{
  "authority": "Amsterdam",
  "from": "2026-09-01",
  "q": "omgevingsvergunning",
  "until": "2026-09-11"
}

Example response

{
  "coverage": {
    "complete": false,
    "scope": "Official publication title search; sorted by modification date. Not consolidated current law."
  },
  "items": [
    {
      "authority": "Amsterdam",
      "id": "gmb-2026-427235",
      "modified": "2026-09-11",
      "publication": "Gemeenteblad",
      "published": "2026-09-11",
      "summary": "toevoegen van een vloer, wijzigen indeling en brandcompartimentering,  en toevoegen woning",
      "title": "Aanvraag omgevingsvergunning Tan Malakastraat 80 1087WE Amsterdam",
      "type": "omgevingsvergunning",
      "url": "https://zoek.officielebekendmakingen.nl/gmb-2026-427235.html"
    },
    {
      "authority": "Amsterdam",
      "id": "gmb-2026-428658",
      "modified": "2026-09-11",
      "publication": "Gemeenteblad",
      "published": "2026-09-11",
      "summary": "veranderen en vergroten van de woning d.m.v. een dakopbouw",
      "title": "Aanvraag omgevingsvergunning Kantershof 574 1104HG Amsterdam",
      "type": "omgevingsvergunning",
      "url": "https://zoek.officielebekendmakingen.nl/gmb-2026-428658.html"
    }
  ],
  "next_start": 3,
  "notice": "An application notice is not an issued permit. Company-name mentions do not establish identity or a complete permit history.",
  "query": {
    "authority": "Amsterdam",
    "limit": "2",
    "q": "omgevingsvergunning"
  },
  "source_url": "https://repository.overheid.nl/sru?operation=searchRetrieve&version=2.0&httpAccept=application%2Fjson&query=c.product-area%3D%3Dofficielepublicaties+AND+dt.title%3D%22omgevingsvergunning%22+AND+dt.creator%3D%3D%22Amsterdam%22+sortBy+dt.modified%2Fsort.descending&startRecord=1&maximumRecords=2",
  "start": 1,
  "total": 101939
}

Links

External documentation ↗

GET/sru/Search

$0.10 default

Description

Search CVDR local and BWB national regulation titles

Documentation

Search CVDR local and BWB national regulation titles

Search Staatscourant notices, local regulations (CVDR), and national legislation (BWB). Returned metadata can include historic versions; inspect effective dates and original documents.

Pricing

$0.10 default

Parameters

{
  "properties": {
    "limit": {
      "description": "Maximum records in this paid page",
      "maximum": 25,
      "minimum": 1,
      "type": "integer",
      "x-parameter-location": "query"
    },
    "q": {
      "description": "Literal title or search keyword; not a query expression.",
      "maxLength": 200,
      "minLength": 1,
      "type": "string",
      "x-parameter-location": "query"
    },
    "start": {
      "description": "One-based next start record from the prior result",
      "maximum": 100000,
      "minimum": 1,
      "type": "integer",
      "x-parameter-location": "query"
    },
    "x-connection": {
      "description": "KOOP regulation collection",
      "enum": [
        "cvdr",
        "BWB"
      ],
      "maxLength": 200,
      "minLength": 1,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "x-connection",
    "q"
  ],
  "type": "object"
}

Request schema

{
  "properties": {},
  "required": [],
  "type": "object"
}

Response schema

{
  "properties": {
    "coverage": {
      "properties": {
        "complete": {
          "type": "boolean"
        },
        "scope": {
          "description": "Scope of the returned response",
          "maxLength": 2000,
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "complete",
        "scope"
      ],
      "type": "object"
    },
    "data": {
      "properties": {
        "collection": {
          "type": "string"
        },
        "items": {
          "items": {
            "type": "object"
          },
          "type": "array"
        },
        "next_start": {
          "type": [
            "integer",
            "null"
          ]
        },
        "start": {
          "minimum": 1,
          "type": "integer"
        },
        "total": {
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "items",
        "total",
        "start",
        "next_start"
      ],
      "type": "object"
    },
    "notice": {
      "description": "Source limitations",
      "maxLength": 2000,
      "minLength": 1,
      "type": "string"
    },
    "source_url": {
      "description": "Exact upstream request URL",
      "maxLength": 20000,
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "data",
    "source_url",
    "notice",
    "coverage"
  ],
  "type": "object"
}

Example request

{
  "limit": 2,
  "q": "water",
  "x-connection": "cvdr"
}

Example response

{
  "coverage": {
    "complete": false,
    "scope": "One bounded upstream response per purchased call"
  },
  "data": {
    "collection": "cvdr",
    "items": [
      {
        "id": "CVDR743806_1",
        "metadata": {
          "alternatieveIdentifier": [
            "/akn/nl/act/gemeente/2025/CVDR743806",
            "/akn/nl/act/gemeente/2025/CVDR743806/nld@2025-09-03",
            "/akn/nl/act/gm0342/2025/2_8",
            "/akn/nl/act/gm0342/2025/2_8/nld@21"
          ],
          "alternative": [
            "Omgevingsprogramma Water"
          ],
          "creator": [
            "Soest"
          ],
          "identifier": [
            "CVDR743806_1"
          ],
          "indeling": [
            "overig"
          ],
          "inwerkingtredingDatum": [
            "2025-09-03"
          ],
          "isFormatOf": [
            "gmb-2025-384732"
          ],
          "isRatifiedBy": [
            "gemeenteraad"
          ],
          "language": [
            "nl"
          ],
          "modified": [
            "2026-07-21Z"
          ],
          "omgevingswet": [
            "ja"
          ],
          "onderwerp": [
            "ruimtelijke ordening"
          ],
          "organisatietype": [
            "Gemeente"
          ],
          "preferred_url": [
            "https://lokaleregelgeving.overheid.nl/CVDR743806/1"
          ],
          "preferred_work_url": [
            "https://lokaleregelgeving.overheid.nl/CVDR743806"
          ],
          "publicatieurl_xml": [
            "https://repository.officiele-overheidspublicaties.nl/cvdr/CVDR743806/1/xml/CVDR743806_1.xml"
          ],
          "recordPacking": [
            "xml"
          ],
          "recordPosition": [
            "1"
          ],
          "recordSchema": [
            "http://standaarden.overheid.nl/sru/"
          ],
          "source": [
            "Artikel 3.4 Omgevingswet"
          ],
          "subject": [
            "algemeen"
          ],
          "title": [
            "Omgevingsprogramma Water"
          ],
          "type": [
            "regeling"
          ]
        },
        "title": "Omgevingsprogramma Water",
        "url": "https://lokaleregelgeving.overheid.nl/CVDR743806/1"
      },
      {
        "id": "CVDR120246_1",
        "metadata": {
          "alternative": [
            "Verordening openbaar water"
          ],
          "betreft": [
            "nieuwe regeling"
          ],
          "creator": [
            "Alkmaar"
          ],
          "gedelegeerdeRegelgeving": [
            "<al>Geen</al>"
          ],
          "identifier": [
            "CVDR120246_1"
          ],
          "indeling": [
            "overig"
          ],
          "intrekkingRegeling": [
            "2016-10-27"
          ],
          "inwerkingtredingDatum": [
            "2011-11-10"
          ],
          "isFormatOf": [
            "Officiële Mededelingen, 02-11-2011"
          ],
          "isRatifiedBy": [
            "college van burgemeester en wethouders"
          ],
          "issued": [
            "2011-10-27"
          ],
          "kenmerk": [
            "Onbekend."
          ],
          "language": [
            "nl"
          ],
          "modified": [
            "2018-05-29"
          ],
          "omgevingswet": [
            "nee"
          ],
          "organisatietype": [
            "Gemeente"
          ],
          "preferred_url": [
            "https://lokaleregelgeving.overheid.nl/CVDR120246/1"
          ],
          "preferred_work_url": [
            "https://lokaleregelgeving.overheid.nl/CVDR120246"
          ],
          "publicatieurl_xml": [
            "https://repository.officiele-overheidspublicaties.nl/cvdr/CVDR120246/1/xml/CVDR120246_1.xml"
          ],
          "recordPacking": [
            "xml"
          ],
          "recordPosition": [
            "2"
          ],
          "recordSchema": [
            "http://standaarden.overheid.nl/sru/"
          ],
          "redactioneleToevoeging": [
            "<al>Deze regeling is vervangen door de <extref doc=\"1.1:CVDR408727_1\">Verordening openbaar water</extref>.</al>"
          ],
          "source": [
            "Gemeentewet, art. 149"
          ],
          "subject": [
            "ruimtelijke ordening, verkeer en vervoer"
          ],
          "title": [
            "Verordening openbaar water"
          ],
          "type": [
            "regeling"
          ],
          "uitwerkingtredingDatum": [
            "2016-10-27"
          ]
        },
        "title": "Verordening openbaar water",
        "url": "https://lokaleregelgeving.overheid.nl/CVDR120246/1"
      }
    ],
    "next_start": 3,
    "start": 1,
    "total": 528
  },
  "notice": "Returned regulation metadata may include historic versions. Check effective dates and original text before drawing legal conclusions.",
  "source_url": "https://zoekservice.overheid.nl/sru/Search?x-connection=cvdr&operation=searchRetrieve&version=2.0&query=dcterms.title+any+%22water%22&startRecord=1&maximumRecords=2"
}

Links

External documentation ↗