Index onlineMerchant portal
Api Endpoint

Factline

Use when you need to check that a Dutch address exists or get its exact spelling and coordinates: official BAG address from postcode + house number or free text, latitude/longitude, BAG ids, municipality, province and CBS neighbourhood code. Cheap address validation for onboarding, delivery and CRM. Source: Kadaster BAG via PDOK.

Open interactive test console

Offering

Provider
factline.dev
Method
GET
Offering type
Api Endpoint
Transport type
http
Category
Location And Travel
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://factline.dev/v1/address/lookup
MIME type
application/json
First seen
2026-10-16T01:50:32.458Z
Last seen
Tags
netherlands, europe, address-verification, geocoding, KYC, postcode, Validation

Website

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.002 USDC
Atomic price: 2000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Payment option 2
0.002 USDC
Atomic price: 2000 · Network: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "2000",
    "payTo": "0xb58dd178abac67f6d4894437a7fc725cbddb2075"
  },
  {
    "scheme": "exact",
    "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
    "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "amount": "2000",
    "payTo": "fyqifu7otDYanhqr84B9YzZfA5LwRTJ1uFLqDJinMTK"
  }
]

Observed health

Status
Healthy
Latest latency
1616 ms
Average latency
827 ms
HTTP status
402
Last checked
Reachability
100% over 12 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "const": "http"
    },
    "method": {
      "type": "string",
      "enum": [
        "GET"
      ]
    },
    "queryParams": {
      "type": "object",
      "properties": {
        "postcode": {
          "type": "string",
          "description": "Dutch postcode, 4 digits + 2 letters, e.g. 3511LX",
          "pattern": "^[1-9][0-9]{3} ?[A-Za-z]{2}$"
        },
        "house_number": {
          "type": "integer",
          "description": "House number, e.g. 1",
          "minimum": 1
        },
        "house_letter": {
          "type": "string",
          "description": "Optional house letter, e.g. A"
        },
        "addition": {
          "type": "string",
          "description": "Optional house number addition, e.g. 2 or BIS"
        },
        "q": {
          "type": "string",
          "description": "Alternative to postcode: free-text address, e.g. 'Visschersplein 1 Utrecht'"
        }
      }
    }
  },
  "required": [
    "type",
    "method"
  ],
  "additionalProperties": false
}

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "method": {
          "enum": [
            "GET"
          ],
          "type": "string"
        },
        "queryParams": {
          "properties": {
            "addition": {
              "description": "Optional house number addition, e.g. 2 or BIS",
              "type": "string"
            },
            "house_letter": {
              "description": "Optional house letter, e.g. A",
              "type": "string"
            },
            "house_number": {
              "description": "House number, e.g. 1",
              "minimum": 1,
              "type": "integer"
            },
            "postcode": {
              "description": "Dutch postcode, 4 digits + 2 letters, e.g. 3511LX",
              "pattern": "^[1-9][0-9]{3} ?[A-Za-z]{2}$",
              "type": "string"
            },
            "q": {
              "description": "Alternative to postcode: free-text address, e.g. 'Visschersplein 1 Utrecht'",
              "type": "string"
            }
          },
          "type": "object"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "type": "object"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}