# GetApi DSO Documents — Dutch Spatial Planning Documents Lookup

> GetApi DSO Documents — Dutch Spatial Planning Documents Lookup is a paid API for AI agents from api.getapi.nl, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Retrieves spatial planning documents (bestemmingsplannen) from the Dutch DSO (Digitaal Stelsel Omgevingswet) registry

## Facts

- Endpoint: GET https://api.getapi.nl/api/v1/dso/documents
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/getapi-dso-documents-dutch-spatial-planning-documents-lookup-85751151
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_TPOq6OEcTcNR68js33gWA

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability getapi-dso-documents-dutch-spatial-planning-documents-lookup-85751151
```

Example prompt: Can you look up the bestemmingsplan documents for the Centrum area in Amsterdam — I need the official plan name, type, and the ruimtelijkeplannen viewer link?

## When to prefer this

Choose this endpoint when you need structured access to official Dutch spatial planning documents from the DSO registry, especially when you require IMRO identification codes, plan types, and direct links to the ruimtelijkeplannen.nl viewer. Prefer this over manual web scraping of ruimtelijkeplannen.nl when you need machine-readable, structured results for programmatic use in real estate research, permit workflows, or planning compliance checks.

## Known failure modes

- No documents found for given query parameters — empty resultaten array
- Invalid or missing query parameters — 400 Bad Request
- DSO upstream service unavailable — 502 or 503 error
- Payment not processed — 402 Payment Required (x402 protocol)
- Rate limit exceeded — 429 Too Many Requests

## How this service works

Ontdek, test en integreer krachtige API's voor web scraping, e-mailvalidatie, geolocatie
    en meer. Gratis starten.

## Output

Returns a JSON object with an _embedded.resultaten array, where each item contains: naam (plan name), type (e.g. bestemmingsplan), plan_url (link to ruimtelijkeplannen.nl viewer), and identificatie (IMRO code such as NL.IMRO.xxxx).

## Request schema (JSON Schema)

```json
{
 "properties": {
  "input": {
   "properties": {
    "queryParams": {
     "type": "object",
     "properties": {
      "lat": 1,
      "lon": 1,
      "postcode": "1011AB",
      "huisnummer": 1
     }
    }
   }
  },
  "output": {
   "properties": {
    "example": {
     "_embedded": {
      "resultaten": [
       {
        "identificatie": "NL.IMRO.0363.A1234BPSTD-VG01",
        "naam": "Bestemmingsplan Centrum",
        "type": "bestemmingsplan",
        "plan_url": "https://www.ruimtelijkeplannen.nl/viewer/viewer?planidn=NL.IMRO.0363.A1234BPSTD-VG01"
       }
      ]
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "_embedded": {
   "resultaten": [
    {
     "naam": "Bestemmingsplan Centrum",
     "type": "bestemmingsplan",
     "plan_url": "https://www.ruimtelijkeplannen.nl/viewer/viewer?planidn=NL.IMRO.0363.A1234BPSTD-VG01",
     "identificatie": "NL.IMRO.0363.A1234BPSTD-VG01"
    }
   ]
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/getapi-dso-documents-dutch-spatial-planning-documents-lookup-85751151/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.getapi.nl](https://www.zero.xyz/host/api.getapi.nl/llms.txt)