{
  "info": {
    "_postman_id": "17273d29-4670-440e-8aa7-df614434bccf",
    "name": "Kukun API - v1",
    "description": "Postman collection for the Kukun REST API. Use this collection to explore, test, and integrate permit search capabilities into your applications.\n\n**Base URL:** `{{base_url}}` → `https://api.mykukun.com/v1`\n\n**Authentication:** All requests require your API key in the header as Authorization: Bearer YOUR_API_KEY. Set it once in the environment file and every request inherits it.\n\nFor full parameter docs and response schemas, visit [https://portal.mykukun.com/api-quickstart](https://portal.mykukun.com/api-quickstart).",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
    "_exporter_id": "6882317",
    "_collection_link": "https://go.postman.co/collection/6882317-17273d29-4670-440e-8aa7-df614434bccf?source=collection_link"
  },
  "item": [
    {
      "name": "Permits",
      "item": [
        {
          "name": "Search Permits",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "",
                "value": "",
                "type": "text",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{base_url}}/permits/search?status=applied&label=new-construct&jurisdiction=Kansas City&page=101&limit=20",
              "host": ["{{base_url}}"],
              "path": ["permits", "search"],
              "query": [
                {
                  "key": "status",
                  "value": "applied"
                },
                {
                  "key": "label",
                  "value": "new-construct"
                },
                {
                  "key": "address",
                  "value": "449 W 67th Ter",
                  "disabled": true
                },
                {
                  "key": "state",
                  "value": "MO",
                  "disabled": true
                },
                {
                  "key": "zip-code",
                  "value": "64113",
                  "disabled": true
                },
                {
                  "key": "city",
                  "value": "Kansas City",
                  "disabled": true
                },
                {
                  "key": "county",
                  "value": "Jackson",
                  "disabled": true
                },
                {
                  "key": "jurisdiction",
                  "value": "Kansas City"
                },
                {
                  "key": "latitude",
                  "value": "39.00652",
                  "disabled": true
                },
                {
                  "key": "longitude",
                  "value": "-94.59405",
                  "disabled": true
                },
                {
                  "key": "distance",
                  "value": "5",
                  "disabled": true
                },
                {
                  "key": "sort-by",
                  "value": "state",
                  "disabled": true
                },
                {
                  "key": "sort-order",
                  "value": "desc",
                  "disabled": true
                },
                {
                  "key": "date-from",
                  "value": "2026-01-06",
                  "disabled": true
                },
                {
                  "key": "date-to",
                  "value": "2026-05-15",
                  "disabled": true
                },
                {
                  "key": "page",
                  "value": "101"
                },
                {
                  "key": "limit",
                  "value": "20"
                },
                {
                  "key": "details",
                  "value": "0",
                  "type": "text",
                  "disabled": true
                }
              ]
            }
          },
          "response": []
        },
        {
          "name": "Area Search",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/permits/area-search?label=new-construct&label-condition=has&date-from=2026-01-01&date-to=2026-06-01",
              "host": ["{{base_url}}"],
              "path": ["permits", "area-search"],
              "query": [
                {
                  "key": "zip-code",
                  "value": "64113",
                  "disabled": true
                },
                {
                  "key": "city",
                  "value": "Kansas City",
                  "disabled": true
                },
                {
                  "key": "county",
                  "value": "Jackson",
                  "disabled": true
                },
                {
                  "key": "state",
                  "value": "MO",
                  "disabled": true
                },
                {
                  "key": "latitude",
                  "value": "39.00652",
                  "disabled": true
                },
                {
                  "key": "longitude",
                  "value": "-94.59405",
                  "disabled": true
                },
                {
                  "key": "distance",
                  "value": "5",
                  "disabled": true
                },
                {
                  "key": "label",
                  "value": "new-construct"
                },
                {
                  "key": "label-condition",
                  "value": "has"
                },
                {
                  "key": "date-from",
                  "value": "2026-01-01"
                },
                {
                  "key": "date-to",
                  "value": "2026-06-01"
                },
                {
                  "key": "limit",
                  "value": "50",
                  "disabled": true
                },
                {
                  "key": "next-page-id",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "details",
                  "value": "1",
                  "disabled": true
                }
              ]
            },
            "description": "Returns deduplicated addresses that either have or are missing a permit label within a date window. Use label-condition=has for addresses with matching permits, or label-condition=missing for addresses without matching permits."
          },
          "response": []
        }
      ],
      "description": "Use it to search and filter permit records by location, status, label, date range, and geo-distance."
    }
  ],
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "YOUR_API_KEY",
        "type": "string"
      }
    ]
  },
  "event": [
    {
      "listen": "prerequest",
      "script": {
        "type": "text/javascript",
        "requests": {},
        "exec": [
          "pm.request.headers.add({key: 'Accept', value: 'application/json' })",
          "pm.request.headers.add({key: 'Content-Type', value: 'application/json' })",
          "",
          "",
          "pm.request.headers.add({key: 'access-token', value: 'c63192e163317c66b08e90a6addf5557' })"
        ]
      }
    },
    {
      "listen": "test",
      "script": {
        "type": "text/javascript",
        "requests": {},
        "exec": [""]
      }
    }
  ],
  "variable": [
    {
      "key": "base_url",
      "value": "https://api.mykukun.com/v1"
    }
  ]
}