{
  "info": {
    "name": "Postcode API - Dutch Address Lookup",
    "description": "REST API for Dutch postcode lookup, autocomplete, and address resolution. Get city, municipality, province, and coordinates for any Dutch postcode.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "variable": [
    {
      "key": "base_url",
      "value": "https://postcode.frontierlabs.nl"
    },
    {
      "key": "api_key",
      "value": "pc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
    }
  ],
  "item": [
    {
      "name": "Search",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{api_key}}",
            "type": "text"
          }
        ],
        "url": {
          "raw": "{{base_url}}/api/postcode/search?q=1234",
          "host": ["{{base_url}}"],
          "path": ["api", "postcode", "search"],
          "query": [
            {
              "key": "q",
              "value": "1234",
              "description": "Postcode (e.g. 1234) or city name"
            }
          ]
        },
        "description": "Full postcode search. Returns city, municipality, province, coordinates. Deducts 1 credit."
      }
    },
    {
      "name": "Autocomplete",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{api_key}}",
            "type": "text"
          }
        ],
        "url": {
          "raw": "{{base_url}}/api/postcode/autocomplete?q=exam",
          "host": ["{{base_url}}"],
          "path": ["api", "postcode", "autocomplete"],
          "query": [
            {
              "key": "q",
              "value": "exam",
              "description": "Partial postcode or city name"
            }
          ]
        },
        "description": "Autocomplete suggestions. Does not deduct credits."
      }
    },
    {
      "name": "Address Lookup",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{api_key}}",
            "type": "text"
          }
        ],
        "url": {
          "raw": "{{base_url}}/api/address/lookup?postcode=1234AB&number=1",
          "host": ["{{base_url}}"],
          "path": ["api", "address", "lookup"],
          "query": [
            {
              "key": "postcode",
              "value": "1234AB",
              "description": "Full Dutch postcode (4 digits + 2 letters)"
            },
            {
              "key": "number",
              "value": "1",
              "description": "House number"
            }
          ]
        },
        "description": "Resolve postcode + house number to street name, city, municipality, province. Deducts 1 credit."
      }
    },
    {
      "name": "Test Search",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{base_url}}/api/test/search?q=1234",
          "host": ["{{base_url}}"],
          "path": ["api", "test", "search"],
          "query": [
            {
              "key": "q",
              "value": "1234",
              "description": "Any value (returns hardcoded dummy data)"
            }
          ]
        },
        "description": "Dummy search endpoint for testing. No auth required, no credits deducted. Always returns the same hardcoded results."
      }
    },
    {
      "name": "Test Autocomplete",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{base_url}}/api/test/autocomplete?q=amst",
          "host": ["{{base_url}}"],
          "path": ["api", "test", "autocomplete"],
          "query": [
            {
              "key": "q",
              "value": "amst",
              "description": "Any value (returns hardcoded dummy data)"
            }
          ]
        },
        "description": "Dummy autocomplete endpoint for testing. No auth required, no credits deducted."
      }
    },
    {
      "name": "Test Address Lookup",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{base_url}}/api/test/address?postcode=1234AB&number=1",
          "host": ["{{base_url}}"],
          "path": ["api", "test", "address"],
          "query": [
            {
              "key": "postcode",
              "value": "1234AB",
              "description": "Valid Dutch postcode format (4 digits + 2 letters)"
            },
            {
              "key": "number",
              "value": "1",
              "description": "Any positive house number"
            }
          ]
        },
        "description": "Dummy address lookup endpoint for testing. No auth required, no credits deducted."
      }
    }
  ]
}