PostNL Address API

The Address API from PostNL — 4 operation(s) for address.

GitHub OpenAPI

Operations 4

GET /v2/address/benelux Get address benelux #
GET /v4/address/international Get address international #
GET /v4/address/netherlands Get address netherlands #
POST /address/national/insight/v1/basic Create address national insight basic #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/postnl:postnl-address-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

postnl-address-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: DS-AddressValidationBenelux Address API
  version: v2
  description: Documentation for DS-AddressValidationBenelux-v2
servers:
- url: https://api-sandbox.postnl.nl/
  description: Non-Production server
- url: https://api.postnl.nl/
  description: Production server
security:
- apikey: []
tags:
- name: Address
paths:
  /v2/address/benelux:
    get:
      parameters:
      - name: houseNumber
        in: query
        required: true
        schema:
          type: string
      - name: postalCode
        in: query
        required: true
        schema:
          type: string
      - name: countryIso
        in: query
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Succesful response
        '401':
          description: Invalid apikey
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DS-AddressValidationBeneluxUnauthorized'
        '405':
          description: Method not allowed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DS-AddressValidationBeneluxMethodNotAllowed'
        '429':
          description: Too many requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DS-AddressValidationBeneluxTooManyRequest'
      tags:
      - Address
      summary: Get address benelux
      x-summary-source: derived
      operationId: getV2AddressBenelux
      x-operation-id-source: derived
  /v4/address/international:
    get:
      parameters:
      - name: houseNumber
        in: query
        required: true
        schema:
          type: string
      - name: postalCode
        in: query
        required: true
        schema:
          type: string
      - name: countryIso
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Succesful response
        '401':
          description: Invalid apikey
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DS-AddressValidationInternationalUnauthorized'
        '405':
          description: Method not allowed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DS-AddressValidationInternationalMethodNotAllowed'
        '429':
          description: Too many requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DS-AddressValidationInternationalTooManyRequest'
      tags:
      - Address
      summary: Get address international
      x-summary-source: derived
      operationId: getV4AddressInternational
      x-operation-id-source: derived
  /v4/address/netherlands:
    get:
      parameters:
      - name: houseNumber
        in: query
        required: true
        schema:
          type: string
      - name: postalCode
        in: query
        required: true
        schema:
          type: string
      - name: countryIso
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Succesful response
        '401':
          description: Invalid apikey
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DS-AddressValidationNetherlandsUnauthorized'
        '405':
          description: Method not allowed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DS-AddressValidationNetherlandsMethodNotAllowed'
        '429':
          description: Too many requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DS-AddressValidationNetherlandsTooManyRequest'
      tags:
      - Address
      summary: Get address netherlands
      x-summary-source: derived
      operationId: getV4AddressNetherlands
      x-operation-id-source: derived
  /address/national/insight/v1/basic:
    post:
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/adresinbeeldRequest'
        required: true
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/adresinbeeldResponse'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostDS-AdresinBeeld-BasicBadRequest'
        '401':
          description: Invalid apikey
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostDS-AdresinBeeld-BasicUnauthorized'
        '405':
          description: Method not allowed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostDS-AdresinBeeld-BasicMethodNotAllowed'
        '429':
          description: Too many requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostDS-AdresinBeeld-BasicTooManyRequest'
        '500':
          description: Internal server error
          content: {}
      tags:
      - Address
      summary: Create address national insight basic
      x-summary-source: derived
      operationId: postAddressNationalInsightV1Basic
      x-operation-id-source: derived
components:
  schemas:
    DS-AddressValidationBeneluxTooManyRequest:
      type: object
      properties:
        message:
          type: string
          example: Too many requests. Rate limit exceeded!
        http_status_code:
          type: number
          example: 429
    DS-AddressValidationBeneluxUnauthorized:
      type: object
      properties:
        message:
          type: string
          example: Failed to resolve API Key variable 'request.header.apikey'
        http_status_code:
          type: number
          example: 401
    DS-AddressValidationBeneluxMethodNotAllowed:
      type: object
      properties:
        message:
          type: string
          example: Only GET requests allowed
        http_status_code:
          type: number
          example: 405
    DS-AddressValidationInternationalMethodNotAllowed:
      type: object
      properties:
        message:
          type: string
          example: Only GET requests allowed
        http_status_code:
          type: number
          example: 405
    DS-AddressValidationInternationalTooManyRequest:
      type: object
      properties:
        message:
          type: string
          example: Too many requests. Rate limit exceeded!
        http_status_code:
          type: number
          example: 429
    DS-AddressValidationInternationalUnauthorized:
      type: object
      properties:
        message:
          type: string
          example: Failed to resolve API Key variable 'request.header.apikey'
        http_status_code:
          type: number
          example: 401
    DS-AddressValidationNetherlandsMethodNotAllowed:
      type: object
      properties:
        message:
          type: string
          example: Only GET requests allowed
        http_status_code:
          type: number
          example: 405
    DS-AddressValidationNetherlandsTooManyRequest:
      type: object
      properties:
        message:
          type: string
          example: Too many requests. Rate limit exceeded!
        http_status_code:
          type: number
          example: 429
    DS-AddressValidationNetherlandsUnauthorized:
      type: object
      properties:
        message:
          type: string
          example: Failed to resolve API Key variable 'request.header.apikey'
        http_status_code:
          type: number
          example: 401
    PostDS-AdresinBeeld-BasicBadRequest:
      type: object
      properties:
        message:
          type: string
          example: Query must include PostalCode, HouseNumber and Selection
        http_status_code:
          type: number
          example: 400
    PostDS-AdresinBeeld-BasicTooManyRequest:
      type: object
      properties:
        message:
          type: string
          example: Too many requests. Rate limit exceeded!
        http_status_code:
          type: number
          example: 429
    adresinbeeldResponse:
      type: object
      example:
        Address:
          PostalCode: 3039DD
          HouseNumber: 24
          HouseNumberAddition: A
    PostDS-AdresinBeeld-BasicUnauthorized:
      type: object
      properties:
        message:
          type: string
          example: Failed to resolve API Key variable 'request.header.apikey'
        http_status_code:
          type: number
          example: 401
    adresinbeeldRequest:
      type: object
      example:
        PostalCode: 3039DD
        HouseNumber: 24
        HouseNumberAddition: a
        Selection:
        - selectie1
        - selectie2
    PostDS-AdresinBeeld-BasicMethodNotAllowed:
      type: object
      properties:
        message:
          type: string
          example: Only POST requests allowed
        http_status_code:
          type: number
          example: 405
  securitySchemes:
    apikey:
      type: apiKey
      name: apikey
      in: header