← APIs / KOOP Official Publications
Verified

KOOP Official Publications

Apiosk Basicsby Apiosk Basics · General

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.

governmentapi
Price per request
$0.05
About

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.

Base URL
https://gateway.apiosk.com/koop
Technical Specs
Auth Methodnone
Response FormatJSON
Endpoints1
Endpoints
MethodPathDescriptionCost
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.05 default
View details
Endpoint documentation
GET/sru
$0.05 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

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.

Pricing
$0.05 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"
    },
    "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
}