nl.getapi/mcp is an MCP server published by nl.getapi, hosted at api.getapi.nl. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 33 tools, including kadaster.bag.address, kadaster.bag.address.suggest, kadaster.bag.id, cbs.sbi, cbs.sbi.search.
Nederlandse overheids- en registerdata via MCP: KVK, BAG, energielabel, kenteken, DSO en meer.
Nothing else in the archive shares these values.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Address lookup by postcode and house number Returns full BAG address data for a Dutch address, including BAG IDs, usage purposes, surface area, build year, status, and GPS coordinates. Data is sourced from the PDOK BAG open API (Landelijke Voorziening BAG). Results are cached for 24 hours. The upstream timeout is 8 seconds; if PDOK is unavailable the endpoint returns HTTP 503. Source: [PDOK BAG](https://api.pdok.nl/lv/bag/open-api/v1_5) Cost: 1 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.
| Parameter | Type | Description |
|---|---|---|
| postcode * | string | |
| house_letter | ["string","null"] | |
| house_number * | integer | |
| house_number_addition | ["string","null"] |
{
"name": "kadaster.bag.address",
"description": "Address lookup by postcode and house number\n\nReturns full BAG address data for a Dutch address, including BAG IDs,\nusage purposes, surface area, build year, status, and GPS coordinates.\n\nData is sourced from the PDOK BAG open API (Landelijke Voorziening BAG).\n\nResults are cached for 24 hours. The upstream timeout is 8 seconds;\nif PDOK is unavailable the endpoint returns HTTP 503.\n\nSource: [PDOK BAG](https://api.pdok.nl/lv/bag/open-api/v1_5)\n\nCost: 1 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.",
"inputSchema": {
"type": "object",
"required": [
"postcode",
"house_number"
],
"properties": {
"postcode": {
"type": "string"
},
"house_letter": {
"type": [
"string",
"null"
]
},
"house_number": {
"type": "integer"
},
"house_number_addition": {
"type": [
"string",
"null"
]
}
}
},
"annotations": {
"readOnlyHint": true,
"idempotentHint": true
}
}Address autocomplete suggestions Returns address suggestions for autocomplete functionality based on a partial query. Useful for implementing address autocomplete in forms. Returns up to 10 suggestions with full address details and BAG identifiers. Results are cached for 1 hour. Cost: 1 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.
| Parameter | Type | Description |
|---|---|---|
| q * | string | |
| limit | ["integer","null"] |
{
"name": "kadaster.bag.address.suggest",
"description": "Address autocomplete suggestions\n\nReturns address suggestions for autocomplete functionality based on a partial query.\nUseful for implementing address autocomplete in forms. Returns up to 10 suggestions\nwith full address details and BAG identifiers.\n\nResults are cached for 1 hour.\n\nCost: 1 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.",
"inputSchema": {
"type": "object",
"required": [
"q"
],
"properties": {
"q": {
"type": "string"
},
"limit": {
"type": [
"integer",
"null"
]
}
}
},
"annotations": {
"readOnlyHint": true,
"idempotentHint": true
}
}Address lookup by nummeraanduiding ID Returns full BAG address data for a given BAG nummeraanduiding ID. The nummeraanduiding ID is a 16-digit identifier from the BAG register. Data is sourced from the PDOK BAG open API (Landelijke Voorziening BAG). Results are cached for 24 hours. The upstream timeout is 8 seconds; if PDOK is unavailable the endpoint returns HTTP 503. Source: [PDOK BAG](https://api.pdok.nl/lv/bag/open-api/v1_5) Cost: 1 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.
| Parameter | Type | Description |
|---|---|---|
| id * | string |
{
"name": "kadaster.bag.id",
"description": "Address lookup by nummeraanduiding ID\n\nReturns full BAG address data for a given BAG nummeraanduiding ID.\nThe nummeraanduiding ID is a 16-digit identifier from the BAG register.\n\nData is sourced from the PDOK BAG open API (Landelijke Voorziening BAG).\n\nResults are cached for 24 hours. The upstream timeout is 8 seconds;\nif PDOK is unavailable the endpoint returns HTTP 503.\n\nSource: [PDOK BAG](https://api.pdok.nl/lv/bag/open-api/v1_5)\n\nCost: 1 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.",
"inputSchema": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string"
}
}
},
"annotations": {
"readOnlyHint": true,
"idempotentHint": true
}
}SBI code index Returns all SBI codes from the local dataset. Optionally filter by `level` (1–5) and/or `parent_code` to retrieve only the direct children of a given SBI code. Levels: 1 = sectie (A–U), 2 = afdeling, 3 = groep, 4 = klasse, 5 = subklasse. Source: [CBS Standaard Bedrijfsindeling 2025](https://www.cbs.nl/sbi) Cost: 0.5 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.
| Parameter | Type | Description |
|---|---|---|
| level | ["integer","null"] | |
| parent_code | ["string","null"] |
{
"name": "cbs.sbi",
"description": "SBI code index\n\nReturns all SBI codes from the local dataset. Optionally filter by `level` (1–5)\nand/or `parent_code` to retrieve only the direct children of a given SBI code.\n\nLevels: 1 = sectie (A–U), 2 = afdeling, 3 = groep, 4 = klasse, 5 = subklasse.\n\nSource: [CBS Standaard Bedrijfsindeling 2025](https://www.cbs.nl/sbi)\n\nCost: 0.5 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.",
"inputSchema": {
"type": "object",
"properties": {
"level": {
"type": [
"integer",
"null"
]
},
"parent_code": {
"type": [
"string",
"null"
]
}
}
},
"annotations": {
"readOnlyHint": true,
"idempotentHint": true
}
}SBI code search Searches through all SBI codes and titles using a free-text query. Returns up to 25 matches, ordered by level (broad → specific) and code. Source: [CBS Standaard Bedrijfsindeling 2025](https://www.cbs.nl/sbi) Cost: 0.1 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.
| Parameter | Type | Description |
|---|---|---|
| q * | string | |
| limit | ["integer","null"] |
{
"name": "cbs.sbi.search",
"description": "SBI code search\n\nSearches through all SBI codes and titles using a free-text query.\nReturns up to 25 matches, ordered by level (broad → specific) and code.\n\nSource: [CBS Standaard Bedrijfsindeling 2025](https://www.cbs.nl/sbi)\n\nCost: 0.1 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.",
"inputSchema": {
"type": "object",
"required": [
"q"
],
"properties": {
"q": {
"type": "string"
},
"limit": {
"type": [
"integer",
"null"
]
}
}
},
"annotations": {
"readOnlyHint": true,
"idempotentHint": true
}
}SBI code lookup Returns the title, description, level and full classification path for a single SBI code. Accepts both the dotted CBS format (`64.92.3`) and the numeric format (`64923`). Source: [CBS Standaard Bedrijfsindeling 2025](https://www.cbs.nl/sbi) Cost: 0.1 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.
| Parameter | Type | Description |
|---|---|---|
| code * | string |
{
"name": "cbs.sbi.detail",
"description": "SBI code lookup\n\nReturns the title, description, level and full classification path for a single SBI code.\nAccepts both the dotted CBS format (`64.92.3`) and the numeric format (`64923`).\n\nSource: [CBS Standaard Bedrijfsindeling 2025](https://www.cbs.nl/sbi)\n\nCost: 0.1 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.",
"inputSchema": {
"type": "object",
"required": [
"code"
],
"properties": {
"code": {
"type": "string"
}
}
},
"annotations": {
"readOnlyHint": true,
"idempotentHint": true
}
}Nameserver lookup for a domain Returns the NS records for the given domain. Results are cached for 10 minutes. Cost: 1 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.
| Parameter | Type | Description |
|---|---|---|
| domain * | string |
{
"name": "lookup.dns.nameservers",
"description": "Nameserver lookup for a domain\n\nReturns the NS records for the given domain. Results are cached for 10 minutes.\n\nCost: 1 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.",
"inputSchema": {
"type": "object",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string"
}
}
},
"annotations": {
"readOnlyHint": true,
"idempotentHint": true
}
}DNS record lookup for a domain and record type Returns DNS records of the specified type for a domain. Supported types: A, AAAA, CNAME, MX, NS, TXT, SOA, PTR, SRV, ALL (default). Results are cached for 5 minutes. Cost: 1 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.
| Parameter | Type | Description |
|---|---|---|
| type | ["string","null"] | one of ["A","AAAA","CNAME","MX","NS","TXT","SOA","PTR","SRV","ALL",null] |
| domain * | string |
{
"name": "lookup.dns.records",
"description": "DNS record lookup for a domain and record type\n\nReturns DNS records of the specified type for a domain.\n\nSupported types: A, AAAA, CNAME, MX, NS, TXT, SOA, PTR, SRV, ALL (default).\n\nResults are cached for 5 minutes.\n\nCost: 1 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.",
"inputSchema": {
"type": "object",
"required": [
"domain"
],
"properties": {
"type": {
"enum": [
"A",
"AAAA",
"CNAME",
"MX",
"NS",
"TXT",
"SOA",
"PTR",
"SRV",
"ALL",
null
],
"type": [
"string",
"null"
]
},
"domain": {
"type": "string"
}
}
},
"annotations": {
"readOnlyHint": true,
"idempotentHint": true
}
}Check an IP address against DNS-based blacklists (RBLs) Checks an IP address against 5 public DNSBL / RBL zones (Spamhaus, SpamCop, SORBS, Barracuda, PSBL) by querying their DNS-based blacklists. This is a lightweight, realtime check without any external API calls or rate limits. Results are cached per IP for 1 hour. Useful for inbound mail filtering, form submission blocking, and general IP reputation checks. Combine with our email validation APIs for a full anti-spam suite. Cost: 1 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.
| Parameter | Type | Description |
|---|---|---|
| ip * | string |
{
"name": "validation.dnsbl",
"description": "Check an IP address against DNS-based blacklists (RBLs)\n\nChecks an IP address against 5 public DNSBL / RBL zones (Spamhaus, SpamCop,\nSORBS, Barracuda, PSBL) by querying their DNS-based blacklists. This is a\nlightweight, realtime check without any external API calls or rate limits.\nResults are cached per IP for 1 hour.\n\nUseful for inbound mail filtering, form submission blocking, and general\nIP reputation checks. Combine with our email validation APIs for a full\nanti-spam suite.\n\nCost: 1 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.",
"inputSchema": {
"type": "object",
"required": [
"ip"
],
"properties": {
"ip": {
"type": "string"
}
}
},
"annotations": {
"readOnlyHint": true,
"idempotentHint": true
}
}Search environmental documents Searches environmental documents (Omgevingswet and Wro) in context for the given location. Returns all applicable plans, environmental plans and related documents. Accepts coordinates or a postcode. Source: [DSO Omgevingsinformatie Ontsluiten v2](https://developer.omgevingswet.overheid.nl/api-register/api/omgevingsinformatie-ontsluiten/) Cost: 1 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.
| Parameter | Type | Description |
|---|---|---|
| lat | ["number","null"] | |
| lon | ["number","null"] | |
| postcode | ["string","null"] | |
| huisnummer | ["integer","null"] |
{
"name": "dso.documents",
"description": "Search environmental documents\n\nSearches environmental documents (Omgevingswet and Wro) in context for the\ngiven location. Returns all applicable plans, environmental plans and related\ndocuments. Accepts coordinates or a postcode.\n\nSource: [DSO Omgevingsinformatie Ontsluiten v2](https://developer.omgevingswet.overheid.nl/api-register/api/omgevingsinformatie-ontsluiten/)\n\nCost: 1 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.",
"inputSchema": {
"type": "object",
"properties": {
"lat": {
"type": [
"number",
"null"
]
},
"lon": {
"type": [
"number",
"null"
]
},
"postcode": {
"type": [
"string",
"null"
]
},
"huisnummer": {
"type": [
"integer",
"null"
]
}
}
},
"annotations": {
"readOnlyHint": true,
"idempotentHint": true
}
}Search spatial plans Searches spatial plans (Wro) for the given location. Returns zoning plans, integration plans and amendment plans that affect the location. Accepts coordinates or a postcode. Source: [DSO Ruimtelijke Plannen Opvragen v4](https://developer.omgevingswet.overheid.nl/api-register/api/rp-opvragen/) Cost: 1 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.
| Parameter | Type | Description |
|---|---|---|
| lat | ["number","null"] | |
| lon | ["number","null"] | |
| postcode | ["string","null"] | |
| huisnummer | ["integer","null"] |
{
"name": "dso.plans",
"description": "Search spatial plans\n\nSearches spatial plans (Wro) for the given location. Returns zoning plans,\nintegration plans and amendment plans that affect the location. Accepts\ncoordinates or a postcode.\n\nSource: [DSO Ruimtelijke Plannen Opvragen v4](https://developer.omgevingswet.overheid.nl/api-register/api/rp-opvragen/)\n\nCost: 1 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.",
"inputSchema": {
"type": "object",
"properties": {
"lat": {
"type": [
"number",
"null"
]
},
"lon": {
"type": [
"number",
"null"
]
},
"postcode": {
"type": [
"string",
"null"
]
},
"huisnummer": {
"type": [
"integer",
"null"
]
}
}
},
"annotations": {
"readOnlyHint": true,
"idempotentHint": true
}
}Validate an email address Checks the RFC format and verifies that the domain has a valid DNS or MX record. Cost: 1 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.
| Parameter | Type | Description |
|---|---|---|
| email * | string |
{
"name": "validation.email",
"description": "Validate an email address\n\nChecks the RFC format and verifies that the domain has a valid DNS or MX record.\n\nCost: 1 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.",
"inputSchema": {
"type": "object",
"required": [
"email"
],
"properties": {
"email": {
"type": "string"
}
}
},
"annotations": {
"readOnlyHint": true,
"idempotentHint": true
}
}Validate a batch of email addresses Validates up to 25 email addresses in a single request. Each address is checked for RFC format and DNS/MX record existence. Cost: 1 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.
| Parameter | Type | Description |
|---|---|---|
| emails * | array |
{
"name": "validation.email.batch",
"description": "Validate a batch of email addresses\n\nValidates up to 25 email addresses in a single request.\nEach address is checked for RFC format and DNS/MX record existence.\n\nCost: 1 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.",
"inputSchema": {
"type": "object",
"required": [
"emails"
],
"properties": {
"emails": {
"type": "array"
}
}
},
"annotations": {
"readOnlyHint": true,
"idempotentHint": true
}
}Disposable email domain checker Checks the domain against a continuously updated blocklist of known throwaway email services (Mailinator, Guerrilla Mail, 10minutemail, etc.). Cost: 1 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.
| Parameter | Type | Description |
|---|---|---|
| email * | string |
{
"name": "validation.email.disposable",
"description": "Disposable email domain checker\n\nChecks the domain against a continuously updated blocklist of known\nthrowaway email services (Mailinator, Guerrilla Mail, 10minutemail, etc.).\n\nCost: 1 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.",
"inputSchema": {
"type": "object",
"required": [
"email"
],
"properties": {
"email": {
"type": "string"
}
}
},
"annotations": {
"readOnlyHint": true,
"idempotentHint": true
}
}Zipcode lookup for the Netherlands Returns address data for a Dutch postcode, optionally refined by house number. There are multiple sources available with varying coverage and accuracy. Cost: 0.5 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.
| Parameter | Type | Description |
|---|---|---|
| number | ["integer","null"] | |
| postcode * | string |
{
"name": "lookup.postcode",
"description": "Zipcode lookup for the Netherlands\n\nReturns address data for a Dutch postcode, optionally refined by house number.\nThere are multiple sources available with varying coverage and accuracy.\n\nCost: 0.5 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.",
"inputSchema": {
"type": "object",
"required": [
"postcode"
],
"properties": {
"number": {
"type": [
"integer",
"null"
]
},
"postcode": {
"type": "string"
}
}
},
"annotations": {
"readOnlyHint": true,
"idempotentHint": true
}
}Validate an international IBAN / BIC Validates an IBAN (ISO 13616) fully offline: country-specific length + structure and the mod-97 check digit. Supported for 70+ countries. For Dutch IBANs the bank name and BIC are resolved from the bank code. An optional BIC can be submitted to validate its format. No external/network calls are made, so this endpoint is always available and has no rate limits from any third party. Cost: 1 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.
| Parameter | Type | Description |
|---|---|---|
| bic | ["string","null"] | |
| iban * | string |
{
"name": "validation.iban",
"description": "Validate an international IBAN / BIC\n\nValidates an IBAN (ISO 13616) fully offline: country-specific length + structure\nand the mod-97 check digit. Supported for 70+ countries. For Dutch IBANs the\nbank name and BIC are resolved from the bank code. An optional BIC can be\nsubmitted to validate its format.\n\nNo external/network calls are made, so this endpoint is always available and\nhas no rate limits from any third party.\n\nCost: 1 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.",
"inputSchema": {
"type": "object",
"required": [
"iban"
],
"properties": {
"bic": {
"type": [
"string",
"null"
]
},
"iban": {
"type": "string"
}
}
},
"annotations": {
"readOnlyHint": true,
"idempotentHint": true
}
}Get ISP information and location details for an IP address Returns location, ISP, organisation and hosting details for a given IP address. Results are cached for 1 hour. Cost: 1 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.
| Parameter | Type | Description |
|---|---|---|
| ip * | string |
{
"name": "lookup.ip",
"description": "Get ISP information and location details for an IP address\n\nReturns location, ISP, organisation and hosting details for a given IP address.\nResults are cached for 1 hour.\n\nCost: 1 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.",
"inputSchema": {
"type": "object",
"required": [
"ip"
],
"properties": {
"ip": {
"type": "string"
}
}
},
"annotations": {
"readOnlyHint": true,
"idempotentHint": true
}
}Validate a Dutch KVK number (Handelsregister) Quick validation check: is a KVK number registered and active? Returns simple true/false. Local cache (48 hours) serves repeated requests. When the source is temporarily unavailable we return HTTP 503 with `found` and `valid` set to null (unknown). Cost: 0.1 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.
| Parameter | Type | Description |
|---|---|---|
| kvkNummer * | string |
{
"name": "kvk.validate",
"description": "Validate a Dutch KVK number (Handelsregister)\n\nQuick validation check: is a KVK number registered and active?\nReturns simple true/false. Local cache (48 hours) serves repeated requests.\nWhen the source is temporarily unavailable we return HTTP 503 with `found` and `valid` set to null (unknown).\n\nCost: 0.1 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.",
"inputSchema": {
"type": "object",
"required": [
"kvkNummer"
],
"properties": {
"kvkNummer": {
"type": "string"
}
}
},
"annotations": {
"readOnlyHint": true,
"idempotentHint": true
}
}Search businesses Search our company database by company name or KVK number. A local cache (48 hours) serves repeated queries. Results per page can be: 5, 10, 25, 50, or 75 (default 25). KVK API caps results at 50 per request. At least one of `naam` or `kvkNummer` is required. Cost: 1 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.
| Parameter | Type | Description |
|---|---|---|
| naam | string | Company trade name. |
| page | integer | Page number (default 1). |
| size | integer | Results per page: 5, 10, 25, 50, or 75 (default 25). |
| kvkNummer | string | KVK number (8 digits). |
{
"name": "kvk.search",
"description": "Search businesses\n\nSearch our company database by company name or KVK number. A local cache\n(48 hours) serves repeated queries.\nResults per page can be: 5, 10, 25, 50, or 75 (default 25).\nKVK API caps results at 50 per request.\n\nAt least one of `naam` or `kvkNummer` is required.\n\nCost: 1 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.",
"inputSchema": {
"type": "object",
"properties": {
"naam": {
"type": "string",
"description": "Company trade name."
},
"page": {
"type": "integer",
"description": "Page number (default 1)."
},
"size": {
"type": "integer",
"description": "Results per page: 5, 10, 25, 50, or 75 (default 25)."
},
"kvkNummer": {
"type": "string",
"description": "KVK number (8 digits)."
}
}
},
"annotations": {
"readOnlyHint": true,
"idempotentHint": true
}
}KVK detail Returns name, address and active status for a KVK number from our company data. Local cache (48 hours) serves repeated requests. Cost: 1 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.
| Parameter | Type | Description |
|---|---|---|
| kvkNummer * | string |
{
"name": "kvk.detail",
"description": "KVK detail\n\nReturns name, address and active status for a KVK number from our\ncompany data. Local cache (48 hours) serves repeated requests.\n\nCost: 1 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.",
"inputSchema": {
"type": "object",
"required": [
"kvkNummer"
],
"properties": {
"kvkNummer": {
"type": "string"
}
}
},
"annotations": {
"readOnlyHint": true,
"idempotentHint": true
}
}Charging points list Returns a list of all publicly accessible charging points in the Netherlands. Data comes from the NDW Open Data platform (DOT-NL); each charging point includes all available source fields, including the complete `availabilities` (counts, power, current type, tariff IDs and connector format per connector). Optionally paginate with `page` (plus `per_page`, max 500; only then does the response contain a `meta` block). Filter by city, status, availability or connector type. Cost: 0.5 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.
| Parameter | Type | Description |
|---|---|---|
| city | ["string","null"] | |
| page | ["integer","null"] | |
| status | ["string","null"] | |
| per_page | ["integer","null"] | |
| beschikbaar | ["boolean","null"] | |
| connector_types[] | ["array","null"] |
{
"name": "ndw.laadpunten",
"description": "Charging points list\n\nReturns a list of all publicly accessible charging points in the Netherlands.\nData comes from the NDW Open Data platform (DOT-NL); each charging point\nincludes all available source fields, including the complete `availabilities`\n(counts, power, current type, tariff IDs and connector format per connector).\nOptionally paginate with `page` (plus `per_page`, max 500; only then does the\nresponse contain a `meta` block). Filter by city, status, availability or\nconnector type.\n\nCost: 0.5 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.",
"inputSchema": {
"type": "object",
"properties": {
"city": {
"type": [
"string",
"null"
]
},
"page": {
"type": [
"integer",
"null"
]
},
"status": {
"type": [
"string",
"null"
]
},
"per_page": {
"type": [
"integer",
"null"
]
},
"beschikbaar": {
"type": [
"boolean",
"null"
]
},
"connector_types[]": {
"type": [
"array",
"null"
]
}
}
},
"annotations": {
"readOnlyHint": true,
"idempotentHint": true
}
}Charging point detail Returns the details of a single charging point by external ID (EVSEId or locationId), including all available NDW fields and the complete availabilities. Cost: 0.5 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.
| Parameter | Type | Description |
|---|---|---|
| id * | string |
{
"name": "ndw.laadpunten.detail",
"description": "Charging point detail\n\nReturns the details of a single charging point by external ID (EVSEId or\nlocationId), including all available NDW fields and the complete availabilities.\n\nCost: 0.5 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.",
"inputSchema": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string"
}
}
},
"annotations": {
"readOnlyHint": true,
"idempotentHint": true
}
}Emission zones list Returns an overview of all environmental zones (low-emission and zero-emission zones) in the Netherlands. Data comes from the NDW Open Data platform (DATEX II format). Optionally paginate with `page` (plus `per_page`, max 500; only then does the response contain a `meta` block). Filter by zone type or city. Cost: 0.5 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.
| Parameter | Type | Description |
|---|---|---|
| city | ["string","null"] | |
| page | ["integer","null"] | |
| per_page | ["integer","null"] | |
| zone_type | ["string","null"] | one of ["low_emission","zero_emission",null] |
{
"name": "ndw.emissiezones",
"description": "Emission zones list\n\nReturns an overview of all environmental zones (low-emission and zero-emission\nzones) in the Netherlands. Data comes from the NDW Open Data platform\n(DATEX II format). Optionally paginate with `page` (plus `per_page`, max 500;\nonly then does the response contain a `meta` block). Filter by zone type or city.\n\nCost: 0.5 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.",
"inputSchema": {
"type": "object",
"properties": {
"city": {
"type": [
"string",
"null"
]
},
"page": {
"type": [
"integer",
"null"
]
},
"per_page": {
"type": [
"integer",
"null"
]
},
"zone_type": {
"enum": [
"low_emission",
"zero_emission",
null
],
"type": [
"string",
"null"
]
}
}
},
"annotations": {
"readOnlyHint": true,
"idempotentHint": true
}
}Emission zone detail Returns the details of a single emission zone by external ID, including the zone's GeoJSON geometry and vehicle restrictions. Cost: 0.5 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.
| Parameter | Type | Description |
|---|---|---|
| id * | string |
{
"name": "ndw.emissiezones.detail",
"description": "Emission zone detail\n\nReturns the details of a single emission zone by external ID, including the\nzone's GeoJSON geometry and vehicle restrictions.\n\nCost: 0.5 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.",
"inputSchema": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string"
}
}
},
"annotations": {
"readOnlyHint": true,
"idempotentHint": true
}
}Truck parking list Returns an overview of all truck parking locations in the Netherlands with current occupancy information. Static location data is combined with dynamic occupancy status (DATEX II). Optionally paginate with `page` (plus `per_page`, max 500; only then does the response contain a `meta` block). Filter by status, availability or road. Cost: 0.5 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.
| Parameter | Type | Description |
|---|---|---|
| page | ["integer","null"] | |
| road | ["string","null"] | |
| status | ["string","null"] | one of ["available","full","closed","unknown",null] |
| per_page | ["integer","null"] | |
| beschikbaar | ["boolean","null"] |
{
"name": "ndw.truckparking",
"description": "Truck parking list\n\nReturns an overview of all truck parking locations in the Netherlands with\ncurrent occupancy information. Static location data is combined with dynamic\noccupancy status (DATEX II). Optionally paginate with `page` (plus `per_page`,\nmax 500; only then does the response contain a `meta` block). Filter by status,\navailability or road.\n\nCost: 0.5 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.",
"inputSchema": {
"type": "object",
"properties": {
"page": {
"type": [
"integer",
"null"
]
},
"road": {
"type": [
"string",
"null"
]
},
"status": {
"enum": [
"available",
"full",
"closed",
"unknown",
null
],
"type": [
"string",
"null"
]
},
"per_page": {
"type": [
"integer",
"null"
]
},
"beschikbaar": {
"type": [
"boolean",
"null"
]
}
}
},
"annotations": {
"readOnlyHint": true,
"idempotentHint": true
}
}Truck parking detail Returns the details of a single truck parking location by external ID. Cost: 0.5 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.
| Parameter | Type | Description |
|---|---|---|
| id * | string |
{
"name": "ndw.truckparking.detail",
"description": "Truck parking detail\n\nReturns the details of a single truck parking location by external ID.\n\nCost: 0.5 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.",
"inputSchema": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string"
}
}
},
"annotations": {
"readOnlyHint": true,
"idempotentHint": true
}
}Property data lookup (pandgegevens) Returns combined property data for a Dutch address: Address details + BAG identifiers, Energy label info, property value (WOZ waarde), spatial planning data, and environmental information. The `energy_labels` block contains every EP-Online label for this address (complete records, including history); `energy_label`, `energy_details` and `building` continue to expose the most recent label in subset form. This API combines multiple data sources and provides comprehensive property information that is not easily available elsewhere. Also keep in mind that due the multiple underlying API calls, the response time for this endpoint may be longer than typical lookup endpoints, especially on cache misses. Results are cached for 24 hours. Cost: 15 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.
| Parameter | Type | Description |
|---|---|---|
| postcode * | string | |
| house_letter | ["string","null"] | |
| house_number * | integer | |
| house_number_addition | ["string","null"] |
{
"name": "property.pandgegevens",
"description": "Property data lookup (pandgegevens)\n\nReturns combined property data for a Dutch address: Address details + BAG identifiers, Energy label info,\nproperty value (WOZ waarde), spatial planning data, and environmental information.\n\nThe `energy_labels` block contains every EP-Online label for this address\n(complete records, including history); `energy_label`, `energy_details` and\n`building` continue to expose the most recent label in subset form.\n\nThis API combines multiple data sources and provides comprehensive property information\nthat is not easily available elsewhere. Also keep in mind that due the multiple underlying\nAPI calls, the response time for this endpoint may be longer than typical lookup endpoints, especially on cache misses.\n\nResults are cached for 24 hours.\n\nCost: 15 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.",
"inputSchema": {
"type": "object",
"required": [
"postcode",
"house_number"
],
"properties": {
"postcode": {
"type": "string"
},
"house_letter": {
"type": [
"string",
"null"
]
},
"house_number": {
"type": "integer"
},
"house_number_addition": {
"type": [
"string",
"null"
]
}
}
},
"annotations": {
"readOnlyHint": true,
"idempotentHint": true
}
}Lightweight property data lookup (pandgegevens lite) Returns property data for a Dutch address: Address details + BAG identifiers, energy label info, and building characteristics. The `energy_labels` block contains all EP-Online labels (complete records); the summary blocks show the most recent label. This is the lightweight ("lite") version of the pandgegevens API: it deliberately omits the costly WOZ-waarde and DSO spatial/environmental data for a faster and cheaper response. For those, use the full `pandgegevens` API. Results are cached for 24 hours. Cost: 5 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.
| Parameter | Type | Description |
|---|---|---|
| postcode * | string | |
| house_letter | ["string","null"] | |
| house_number * | integer | |
| house_number_addition | ["string","null"] |
{
"name": "property.pandgegevens.lite",
"description": "Lightweight property data lookup (pandgegevens lite)\n\nReturns property data for a Dutch address: Address details + BAG identifiers, energy label info,\nand building characteristics. The `energy_labels` block contains all EP-Online\nlabels (complete records); the summary blocks show the most recent label.\nThis is the lightweight (\"lite\") version of the pandgegevens API:\nit deliberately omits the costly WOZ-waarde and DSO spatial/environmental data for a faster\nand cheaper response. For those, use the full `pandgegevens` API.\n\nResults are cached for 24 hours.\n\nCost: 5 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.",
"inputSchema": {
"type": "object",
"required": [
"postcode",
"house_number"
],
"properties": {
"postcode": {
"type": "string"
},
"house_letter": {
"type": [
"string",
"null"
]
},
"house_number": {
"type": "integer"
},
"house_number_addition": {
"type": [
"string",
"null"
]
}
}
},
"annotations": {
"readOnlyHint": true,
"idempotentHint": true
}
}WOZ-value lookup (WOZ-waarde) Returns the Dutch government property assessment value (WOZ-waarde) for a property, including the historical values of the last three years. Alongside the value, the ground area of the WOZ object (grondoppervlakte) and the linked cadastral parcel (kadastrale gemeente code, sectie and perceelnummer) are returned. The endpoint accepts either a BAG nummeraanduiding identificatie directly, or a Dutch address (postcode + house number, optionally with a house letter or number addition). When an address is supplied, the BAG (PDOK Locatieserver) is queried first to resolve the nummeraanduiding identifier, after which the public sources are queried. When a nummeraanduiding ID is supplied directly, we try to fetch the WOZ value from the public sources. ## Address notation Split a Dutch address into the separate BAG fields. Never put the house letter or the addition in `house_number`, and do not combine them into a single field: - `house_number`: the numeric part only, e.g. `161` - `house_letter`: a single letter, e.g. `C` - `house_number_addition`: the addition without a hyphen and with leading zeros preserved, e.g. `03` (not `3`, `C-03` or `C03`) Example: `Hooidrift 161C-03, 3023KN Rotterdam` → `?postcode=3023KN&house_number=161&house_letter=C&house_number_addition=03`. When the exact `house_number_addition` is unknown but the main address exists, the endpoint falls back to that address and returns HTTP 200 with `matched_on: "without_addition"` and `available_house_number_additions`. This fallback is free (0 credits). Results are cached for 30 days. For some requests we use upstream servers with a default timeout of 8 seconds. Source: Public sources Cost: 10 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.
| Parameter | Type | Description |
|---|---|---|
| id | ["string","null"] | BAG nummeraanduiding identificatie (16 digits). Alternative to postcode + house_number. |
| postcode | ["string","null"] | Dutch postcode, with or without a space (e.g. 3023KN). |
| house_letter | ["string","null"] |
Vehicle lookup by Dutch license plate (kenteken) — Pro / extended response Returns vehicle registration data from the RDW Basisregistratie Voertuigen, enriched with fuel + emission information, a national milieuzone compliance flag, and a wide range of extended fields: catalogusprijs, dimensions, weight limits, body type, axle data and EV-specific specs (range, consumption, continuous power). Results are cached for 24 hours. In addition to the subset fields, the response contains the `rdw` block with the complete source rows from all four RDW Open Data datasets (Kenteken Voertuigen, Brandstof, Carrosserie, Assen); no field is omitted. Columns that RDW leaves empty for a vehicle are `null`. RDW records fuel with one row per fuel type (ordered by `brandstof_volgnummer`). `fuel_type` is the primary fuel (sequence number 1); `fuel_types` contains all registered fuels and `hybrid` is `true` as soon as there is more than one fuel (for example Petrol + Electricity). This distinguishes a hybrid car from a pure combustion or EV car. The `allowed_in_green_zones` flag is derived from the emission class and fuel type using Dutch national milieuzone standards (2024–2025): — Electric / hydrogen / CNG: always allowed — Petrol (any Euro class): allowed — Diesel Euro 6+: allowed — Diesel Euro 5 and below: not allowed — Unknown fuel or emission class: `null` Cost: 1 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.
| Parameter | Type | Description |
|---|---|---|
| license_plate * | string |
{
"name": "rdw.vehicle",
"description": "Vehicle lookup by Dutch license plate (kenteken) — Pro / extended response\n\nReturns vehicle registration data from the RDW Basisregistratie Voertuigen,\nenriched with fuel + emission information, a national milieuzone compliance\nflag, and a wide range of extended fields: catalogusprijs, dimensions,\nweight limits, body type, axle data and EV-specific specs (range, consumption,\ncontinuous power). Results are cached for 24 hours.\n\nIn addition to the subset fields, the response contains the `rdw` block with\nthe complete source rows from all four RDW Open Data datasets (Kenteken\nVoertuigen, Brandstof, Carrosserie, Assen); no field is omitted. Columns that\nRDW leaves empty for a vehicle are `null`.\n\nRDW records fuel with one row per fuel type (ordered by `brandstof_volgnummer`).\n`fuel_type` is the primary fuel (sequence number 1); `fuel_types` contains all\nregistered fuels and `hybrid` is `true` as soon as there is more than one fuel\n(for example Petrol + Electricity). This distinguishes a hybrid car from a pure\ncombustion or EV car.\n\nThe `allowed_in_green_zones` flag is derived from the emission class and fuel type\nusing Dutch national milieuzone standards (2024–2025):\n\n— Electric / hydrogen / CNG: always allowed\n\n— Petrol (any Euro class): allowed\n\n— Diesel Euro 6+: allowed\n\n— Diesel Euro 5 and below: not allowed\n\n— Unknown fuel or emission class: `null`\n\nCost: 1 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.",
"inputSchema": {
"type": "object",
"required": [
"license_plate"
],
"properties": {
"license_plate": {
"type": "string"
}
}
},
"annotations": {
"readOnlyHint": true,
"idempotentHint": true
}
}Energy label lookup for a Dutch address Returns the registered energy label(s) for a Dutch address from EP-Online (RVO). Each label carries the complete EP-Online record (field names are translated to English; fields that EP-Online does not provide for that label are `null`). Results are cached for 24 hours. Source: [EP-Online by RVO](https://ep-online.nl) Cost: 1 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.
| Parameter | Type | Description |
|---|---|---|
| zipcode * | string | |
| house_letter | ["string","null"] | |
| house_number * | integer | |
| house_number_addition | ["string","null"] |
{
"name": "property.energy.label",
"description": "Energy label lookup for a Dutch address\n\nReturns the registered energy label(s) for a Dutch address from EP-Online (RVO).\nEach label carries the complete EP-Online record (field names are translated\nto English; fields that EP-Online does not provide for that label are `null`).\nResults are cached for 24 hours.\nSource: [EP-Online by RVO](https://ep-online.nl)\n\nCost: 1 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.",
"inputSchema": {
"type": "object",
"required": [
"zipcode",
"house_number"
],
"properties": {
"zipcode": {
"type": "string"
},
"house_letter": {
"type": [
"string",
"null"
]
},
"house_number": {
"type": "integer"
},
"house_number_addition": {
"type": [
"string",
"null"
]
}
}
},
"annotations": {
"readOnlyHint": true,
"idempotentHint": true
}
}E-mail Address Extractor Uses a simple regex to extract email addresses from the HTML content of a given URL. It is not always possible to extract email addresses due to obfuscation techniques. In such cases, the api will try to decode it. If it still fails, it will return an empty array. Leave feedback at info@wdnoord.nl if you have a webpage that contains email addresses but they are not extracted correctly and we will try to improve the regex or add support for the obfuscation technique used on that webpage. Cost: 2 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.
| Parameter | Type | Description |
|---|---|---|
| url * | string |
{
"name": "scraping.email",
"description": "E-mail Address Extractor\n\nUses a simple regex to extract email addresses from the HTML content of a given URL. It is not always possible\nto extract email addresses due to obfuscation techniques. In such cases, the api will try to decode it. \n\nIf it still fails, it will return an empty array. Leave feedback at info@wdnoord.nl if you have a webpage that \ncontains email addresses but they are not extracted correctly and we will try to improve the regex or \nadd support for the obfuscation technique used on that webpage.\n\nCost: 2 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.",
"inputSchema": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string"
}
}
},
"annotations": {
"readOnlyHint": true,
"idempotentHint": true
}
}Validate an EU VAT number (VIES) Validates a European VAT number via the official VIES system of the European Commission. The country code must be the first two characters of the VAT number (e.g. `NL820646660B01`). Supported countries: all 27 EU member states + Northern Ireland (XI). When a member state provides it, the response includes the company name and address. We use caching to mitigate VIES rate limits: valid numbers are cached for 24 hours, invalid numbers for 1 hour. When a member state is temporarily unavailable, we return a 503 status with an appropriate error message. Cost: 1 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.
| Parameter | Type | Description |
|---|---|---|
| vat_number * | string |
{
"name": "validation.vat",
"description": "Validate an EU VAT number (VIES)\n\nValidates a European VAT number via the official VIES system of the European Commission.\nThe country code must be the first two characters of the VAT number (e.g. `NL820646660B01`).\nSupported countries: all 27 EU member states + Northern Ireland (XI).\nWhen a member state provides it, the response includes the company name and address.\n\nWe use caching to mitigate VIES rate limits: valid numbers are cached for 24 hours, invalid numbers for 1 hour. When a member state is temporarily unavailable, we return a 503 status with an appropriate error message.\n\nCost: 1 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.",
"inputSchema": {
"type": "object",
"required": [
"vat_number"
],
"properties": {
"vat_number": {
"type": "string"
}
}
},
"annotations": {
"readOnlyHint": true,
"idempotentHint": true
}
}GetApi exposes Dutch government and register data lookups (KVK, BAG, energy label, vehicle registration, DSO and more) as MCP tools. Call tools/list to discover them. Authenticate every tools/call with your API key via the X-Api-Key header (or Authorization: Bearer <key>); a wallet payment via x402 is also accepted. Each call costs credits; some tools are free. Docs: https://getapi.nl/mcp-server-integratie
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
| Single house letter (e.g. C). Do not include the addition here. |
| house_number | ["integer","null"] | Numeric house number only (e.g. 161). |
| house_number_addition | ["string","null"] | Addition without a hyphen, preserving leading zeros (e.g. 03, not 3 or C-03). |
{
"name": "property.woz.waarde",
"description": "WOZ-value lookup (WOZ-waarde)\n\nReturns the Dutch government property assessment value (WOZ-waarde) for a property,\nincluding the historical values of the last three years. Alongside the value, the\nground area of the WOZ object (grondoppervlakte) and the linked cadastral parcel\n(kadastrale gemeente code, sectie and perceelnummer) are returned.\nThe endpoint accepts either a BAG nummeraanduiding identificatie directly, or a\nDutch address (postcode + house number, optionally with a house letter or number\naddition).\n\nWhen an address is supplied, the BAG (PDOK Locatieserver) is queried first to resolve\nthe nummeraanduiding identifier, after which the public sources are queried.\nWhen a nummeraanduiding ID is supplied directly, we try to fetch the WOZ value from the public sources.\n\n## Address notation\n\nSplit a Dutch address into the separate BAG fields. Never put the house letter or the\naddition in `house_number`, and do not combine them into a single field:\n\n- `house_number`: the numeric part only, e.g. `161`\n- `house_letter`: a single letter, e.g. `C`\n- `house_number_addition`: the addition without a hyphen and with leading zeros preserved, e.g. `03` (not `3`, `C-03` or `C03`)\n\nExample: `Hooidrift 161C-03, 3023KN Rotterdam` →\n`?postcode=3023KN&house_number=161&house_letter=C&house_number_addition=03`.\n\nWhen the exact `house_number_addition` is unknown but the main address exists,\nthe endpoint falls back to that address and returns HTTP 200 with\n`matched_on: \"without_addition\"` and `available_house_number_additions`.\nThis fallback is free (0 credits).\n\nResults are cached for 30 days.\n\nFor some requests we use upstream servers with a default timeout of 8 seconds.\n\nSource: Public sources\n\nCost: 10 credit(s) per call. An API key is required via the X-Api-Key header (or Authorization: Bearer <key>); a per-call wallet payment via x402 is also accepted.",
"inputSchema": {
"type": "object",
"properties": {
"id": {
"type": [
"string",
"null"
],
"description": "BAG nummeraanduiding identificatie (16 digits). Alternative to postcode + house_number."
},
"postcode": {
"type": [
"string",
"null"
],
"description": "Dutch postcode, with or without a space (e.g. 3023KN)."
},
"house_letter": {
"type": [
"string",
"null"
],
"description": "Single house letter (e.g. C). Do not include the addition here."
},
"house_number": {
"type": [
"integer",
"null"
],
"description": "Numeric house number only (e.g. 161)."
},
"house_number_addition": {
"type": [
"string",
"null"
],
"description": "Addition without a hyphen, preserving leading zeros (e.g. 03, not 3 or C-03)."
}
}
},
"annotations": {
"readOnlyHint": true,
"idempotentHint": true
}
}