# GetApi DSO Ruimtelijke Plannen — Plans Lookup

> GetApi DSO Ruimtelijke Plannen — Plans 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-10-19).

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

## Facts

- Endpoint: GET https://api.getapi.nl/api/v1/dso/plans?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/getapi-dso-ruimtelijke-plannen-plans-lookup-6b08ff1c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_u_YJWIBoNzyBDxIg3-vzZ

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-ruimtelijke-plannen-plans-lookup-6b08ff1c
```

Example prompt: Can you look up the current bestemmingsplan for the Centrum district in Amsterdam and tell me its status and which government body is responsible?

## When to prefer this

Use this endpoint when you need authoritative Dutch spatial planning data sourced directly from the DSO/Ruimtelijkeplannen.nl registry, particularly when looking up bestemmingsplannen or omgevingsplannen by municipality or plan ID. Prefer this over generic web scraping when structured, machine-readable plan metadata (status, responsible authority, official plan URL) is required for Dutch land use or property research.

## Known failure modes

- No plans found matching the query — returns empty plannen array
- Invalid plan ID format returns a 400 or 404 error
- DSO upstream service unavailable causing 502 or 503 response
- Payment not completed (x402) causing 402 Payment Required response
- Rate limiting if too many requests are made in succession

## 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 containing an embedded list of spatial plans (plannen), each with a unique plan ID (e.g. NL.IMRO format), plan name, type (e.g. bestemmingsplan), a direct URL to the plan viewer on ruimtelijkeplannen.nl, status information including approval date and status label, and the name of the responsible government body (beleidsmatigVerantwoordelijkeOverheid).

## Request schema (JSON Schema)

```json
{
 "properties": {
  "input": {
   "properties": {
    "queryParams": {
     "type": "object",
     "properties": {
      "lat": 1,
      "lon": 1,
      "postcode": "1011AB",
      "huisnummer": 1
     }
    }
   }
  },
  "output": {
   "properties": {
    "example": {
     "_embedded": {
      "plannen": [
       {
        "id": "NL.IMRO.0363.A1234BPSTD-VG01",
        "naam": "Bestemmingsplan Centrum",
        "type": "bestemmingsplan",
        "plan_url": "https://www.ruimtelijkeplannen.nl/viewer/viewer?planidn=NL.IMRO.0363.A1234BPSTD-VG01",
        "planstatusInfo": {
         "datum": "2022-03-15",
         "planstatus": "vastgesteld"
        },
        "beleidsmatigVerantwoordelijkeOverheid": {
         "naam": "gemeente Amsterdam"
        }
       }
      ]
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "_embedded": {
   "plannen": [
    {
     "id": "NL.IMRO.0363.A1234BPSTD-VG01",
     "naam": "Bestemmingsplan Centrum",
     "type": "bestemmingsplan",
     "plan_url": "https://www.ruimtelijkeplannen.nl/viewer/viewer?planidn=NL.IMRO.0363.A1234BPSTD-VG01",
     "planstatusInfo": {
      "datum": "2022-03-15",
      "planstatus": "vastgesteld"
     },
     "beleidsmatigVerantwoordelijkeOverheid": {
      "naam": "gemeente Amsterdam"
     }
    }
   ]
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/getapi-dso-ruimtelijke-plannen-plans-lookup-6b08ff1c/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)