Retrieve a permit

Retrieves a permit with its parcels, addresses, parties, dates, value, fees and decision.

A null decision means the permit is pending.

One credit. Repeat requests within a day are free.

Parameters

path

permit_idrequiredstring: Unique identifier for the permit.

Responses

200: permit object; The permit.
401: ProblemDetail; credential_missing, credential_invalid or credential_expired. The request has no valid credential.
403: ProblemDetail; scope_missing, person_required, api_key_not_accepted or entitlement_missing. The credential or plan does not allow this request. detail names the reason.
404: ProblemDetail; no_such_resource. No permit has this id.
422: ProblemDetail; parameter_invalid, id_malformed or a cursor code. A parameter is missing or invalid. errors lists each one.
429: ProblemDetail; rate_limited. Too many requests. Retry after the Retry-After interval. Nothing is charged.
501: ProblemDetail; not_available. Permit and case data is not available yet.

Example request

curl -X GET 'https://api.placestack.com/v1/permit/pmt_01h455vb4pex5vsknk084sn02q' \
  -H "Authorization: Bearer $PLACESTACK_API_KEY"

Example response

{
  "object": "permit",
  "id": "pmt_01h455vb4pex5vsknk084sn02q",
  "number": "BLDR-026512-2026",
  "type": {
    "code": "Residential Building",
    "description": "Residential Building, Single Family Dwelling"
  },
  "status": {
    "code": "Issued",
    "description": "Issued"
  },
  "jurisdiction": {
    "id": "jur_01h455vb4pex5vsknk084sn02q",
    "name": "Raleigh",
    "type": "city",
    "fips": "3755000",
    "href": "/v1/jurisdiction/jur_01h455vb4pex5vsknk084sn02q"
  },
  "within": [
    {
      "id": "jur_01h455vb4pex5vsknk084sn02q",
      "name": "Wake",
      "tier": "subregion",
      "type": "county",
      "fips": "37183"
    }
  ],
  "agency": {
    "name": "Development Services",
    "type": "building"
  },
  "description": "Screened porch addition to a single-unit dwelling.",
  "parcels": [
    {
      "id": "prc_01h455vb4pex5vsknk084sn02q",
      "number": "1717353946",
      "href": "/v1/parcel/prc_01h455vb4pex5vsknk084sn02q"
    }
  ],
  "addresses": [
    {
      "raw": "4516 PRINTER LN, RALEIGH NC 27613",
      "recipient": "C/O TRIANGLE PROPERTY MANAGEMENT",
      "street_line_1": "4516 PRINTER LN",
      "street_line_2": "APT 1402",
      "street_number": "4516",
      "street_name": "PRINTER",
      "unit": "B",
      "locality": "RALEIGH",
      "region": "NC",
      "postal_code": "27613",
      "point": {
        "lat": 35.8492,
        "lon": -78.6996
      }
    }
  ],
  "parties": [
    {
      "name": "Alex Rivera",
      "role": "contractor",
      "organization": "Triangle Build Co.",
      "license": "75321"
    }
  ],
  "dates": {
    "applied": "2026-03-02",
    "issued": "2026-03-20",
    "decided": "2026-03-20",
    "expires": "2027-03-20",
    "completed": "2026-08-14"
  },
  "valuation": {
    "amount": 48500,
    "currency": "USD"
  },
  "fees": [
    {
      "category": "building",
      "total": 612.5,
      "paid": 612.5,
      "unpaid": 0,
      "waived": 0,
      "currency": "USD"
    }
  ],
  "decision": {
    "outcome": {
      "code": "APPR",
      "description": "Approved"
    },
    "decided_on": "2026-03-18",
    "effective_from": "2026-03-18",
    "effective_to": "2027-03-18",
    "conditions": [
      {
        "text": "Install erosion control measures before any land disturbance.",
        "scope": "Site",
        "timing": "before_permit",
        "due": "2026-04-01"
      }
    ]
  },
  "document": {
    "url": "https://example.com/permit/BLDR-026512-2026",
    "retrieved": "2026-10-01"
  },
  "as_of": "2026-10-01",
  "href": "/v1/permit/pmt_01h455vb4pex5vsknk084sn02q"
}

Parameters

Responses

Next steps

GET /case