Get an application · API reference

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

A decision of null is a request still pending. A scope or an area goes to GET /v1/application instead.

One credit, and free again for a day.

Parameters

path

application_idrequiredstring: The application's id.

Responses

200: Application; Successful Response
401: ProblemDetail; credential_missing, credential_invalid or credential_expired: send a live API key as Authorization: Bearer <key>.
402: ProblemDetail; quota_exhausted: the balance can't cover the call. Nothing was charged and nothing was returned.
403: ProblemDetail; scope_missing, person_required or entitlement_missing: this credential or plan can't do this. detail says which.
404: empty; no_such_resource: no application has this id.
409: ProblemDetail; version_conflict: the record changed since you read it. Read it again and resend.
422: ProblemDetail; parameter_invalid, id_malformed or a cursor code: a parameter's value isn't one this operation takes.
429: ProblemDetail; rate_limited: wait for Retry-After, then send it again. Not charged.
501: empty; not_available: no applications are published yet.

Example request

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

Example response

{
  "object": "application",
  "id": "apl_01h455vb4pex5vsknk084sn02q",
  "kind": "permit",
  "number": "string",
  "type": {
    "code": "string",
    "description": "string",
    "standard": "string"
  },
  "status": {
    "code": "string",
    "description": "string",
    "standard": "string"
  },
  "jurisdiction": {
    "id": "jur_01h455vb4pex5vsknk084sn02q",
    "name": "<Name>",
    "type": "<Type>",
    "href": "<Href>",
    "fips": "string"
  },
  "within": [
    {
      "id": "jur_01h455vb4pex5vsknk084sn02q",
      "name": "<Name>",
      "tier": "<Tier>",
      "type": "<Type>",
      "fips": "string"
    }
  ],
  "agency": {
    "name": "<Name>",
    "type": "string"
  },
  "description": "string",
  "parcels": [
    {
      "id": "prc_01h455vb4pex5vsknk084sn02q",
      "href": "<Href>",
      "number": "string"
    }
  ],
  "addresses": [
    {
      "formatted": "<Formatted>",
      "city": "string",
      "state": "string",
      "postal_code": "string"
    }
  ],
  "parties": [
    {
      "name": "<Name>",
      "role": "string",
      "organization": "string",
      "license": "string"
    }
  ],
  "dates": {
    "applied": "2026-09-13",
    "issued": "2026-09-13",
    "decided": "2026-09-13",
    "expires": "2026-09-13",
    "completed": "2026-09-13"
  },
  "valuation": {
    "amount": 1.25,
    "currency": "<Currency>"
  },
  "fees": [
    {
      "category": "<Category>",
      "total": 1.25,
      "paid": 1.25,
      "unpaid": 1.25,
      "waived": 1.25,
      "currency": "string"
    }
  ],
  "decision": {
    "outcome": "<Code>",
    "conditions": [
      "<Condition>"
    ],
    "decided_on": "2026-09-13",
    "effective_from": "2026-09-13",
    "effective_to": "2026-09-13"
  },
  "zoning": [
    {
      "id": "zon_01h455vb4pex5vsknk084sn02q",
      "code": "<Code>",
      "role": "<Role>",
      "href": "<Href>"
    }
  ],
  "document": {
    "url": "string",
    "retrieved": "2026-09-13"
  },
  "as_of": "2026-09-13",
  "href": "<Href>"
}