Retrieve an application · API reference

An application, with its parcels, addresses, parties, dates, fees, decision and conditions.

A null decision means the application is pending.

One credit. Repeat requests within a day are free.

Parameters

path

application_idrequiredstring: Unique identifier for the application.

Responses

200: application object; The application.
401: ProblemDetail; credential_missing, credential_invalid or credential_expired. The request has no valid credential.
402: ProblemDetail; quota_exhausted. The credit balance is too low for this request. Nothing is charged.
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 application 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. Application data is not available yet.

Example request

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

Example response

{
  "object": "application",
  "id": "apl_01h455vb4pex5vsknk084sn02q",
  "kind": "permit",
  "number": "BLDR-026512-2026",
  "type": {
    "code": "BLDR",
    "description": "Residential building permit"
  },
  "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": [
    {
      "formatted": "4516 PRINTER LN, RALEIGH NC 27613",
      "city": "RALEIGH",
      "state": "NC",
      "postal_code": "27613"
    }
  ],
  "parties": [
    {
      "name": "Alex Rivera",
      "role": "contractor",
      "organization": "Triangle Build Co.",
      "license": "75321"
    }
  ],
  "dates": {
    "applied": "2026-03-02",
    "issued": "2026-03-20",
    "decided": "2026-03-18",
    "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"
      }
    ]
  },
  "zoning": [
    {
      "id": "zon_01h455vb4pex5vsknk084sn02q",
      "code": "R-4",
      "role": "subject",
      "href": "/v1/zoning/zon_01h455vb4pex5vsknk084sn02q"
    }
  ],
  "document": {
    "url": "https://example.com/permit/BLDR-026512-2026",
    "retrieved": "2026-10-01"
  },
  "as_of": "2026-10-01",
  "href": "/v1/application/apl_01h455vb4pex5vsknk084sn02q"
}