{
  "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=closed&state=FL&limit=1000",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "permits",
                "search"
              ],
              "query": [
                {
                  "key": "status",
                  "value": "closed"
                },
                {
                  "key": "label",
                  "value": "roof",
                  "disabled": true
                },
                {
                  "key": "address",
                  "value": "123 Main St",
                  "disabled": true
                },
                {
                  "key": "state",
                  "value": "FL"
                },
                {
                  "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",
                  "disabled": true
                },
                {
                  "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": "2023-01-06",
                  "disabled": true
                },
                {
                  "key": "date-to",
                  "value": "2026-05-15",
                  "disabled": true
                },
                {
                  "key": "page",
                  "value": "1",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "1000"
                },
                {
                  "key": "details",
                  "value": "0",
                  "disabled": true
                }
              ]
            }
          },
          "response": []
        },
        {
          "name": "Area Search by Permits",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "",
                "value": "",
                "type": "text",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{base_url}}/permits/area-search?label=roof&state=FL&county=Broward&label-condition=has&date-from=2018-01-01&date-to=2026-05-01",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "permits",
                "area-search"
              ],
              "query": [
                {
                  "key": "status",
                  "value": "applied",
                  "disabled": true
                },
                {
                  "key": "label",
                  "value": "roof"
                },
                {
                  "key": "address",
                  "value": "123 Main St",
                  "disabled": true
                },
                {
                  "key": "state",
                  "value": "FL"
                },
                {
                  "key": "zip-code",
                  "value": "33093",
                  "disabled": true
                },
                {
                  "key": "city",
                  "value": "Kansas City",
                  "disabled": true
                },
                {
                  "key": "county",
                  "value": "Broward"
                },
                {
                  "key": "jurisdiction",
                  "value": "Kansas City",
                  "disabled": true
                },
                {
                  "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": "page",
                  "value": "1",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "10",
                  "disabled": true
                },
                {
                  "key": "label-condition",
                  "value": "has"
                },
                {
                  "key": "date-from",
                  "value": "2018-01-01"
                },
                {
                  "key": "date-to",
                  "value": "2026-05-01"
                }
              ]
            }
          },
          "response": []
        }
      ],
      "description": "Use it to search and filter permit records by location, status, label, date range, and geo-distance."
    },
    {
      "name": "Property",
      "item": [
        {
          "name": "AVM",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "",
                "value": "",
                "type": "text",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{base_url}}/property/avm?kukun-id=113982207",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "property",
                "avm"
              ],
              "query": [
                {
                  "key": "kukun-id",
                  "value": "113982207"
                },
                {
                  "key": "address",
                  "value": "123 Main St",
                  "disabled": true
                },
                {
                  "key": "city",
                  "value": "Kansas City",
                  "disabled": true
                },
                {
                  "key": "state",
                  "value": "MO",
                  "type": "text",
                  "disabled": true
                },
                {
                  "key": "zip-code",
                  "value": "64113",
                  "disabled": true
                }
              ]
            }
          },
          "response": []
        },
        {
          "name": "Score",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "",
                "value": "",
                "type": "text",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{base_url}}/property/score?kukun-id=113982207",
              "host": ["{{base_url}}"],
              "path": ["property", "score"],
              "query": [
                {
                  "key": "kukun-id",
                  "value": "113982207"
                },
                {
                  "key": "address",
                  "value": "123 Main St",
                  "disabled": true
                },
                {
                  "key": "city",
                  "value": "Kansas City",
                  "disabled": true
                },
                {
                  "key": "state",
                  "value": "MO",
                  "type": "text",
                  "disabled": true
                },
                {
                  "key": "zip-code",
                  "value": "64113",
                  "disabled": true
                }
              ]
            }
          },
          "response": []
        }
      ],
      "description": "Get instant automated property valuations (AVM) by address or Kukun ID. Returns estimated value plus low/high confidence range for U.S. properties."
    }
  ],
  "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"
    }
  ]
}