Get an application's conditions

The conditions on one application's decision notice.

Returns the conditions read from the application's decision notice, in condition-number order, up to 100. The list is empty when the application is undecided or no conditions have been read for it yet.

Not paginated: next_cursor is always null. Each condition returned uses one record, unless you already received it this period.

• Access: API Pro, Leads and National.
• Records: one per condition returned, free if already returned this period. See records and allowances.
• MCP: the get_conditions tool calls this endpoint. See MCP for developers.

Parameters

Example request

curl "https://planningsignal.co.uk/api/v1/applications/pa_3kTq9ZxV1bN7cR2mW8yLpA/conditions" \
  -H "Authorization: Bearer ps_live_your_key_here"

Example response

{
  "data": [
    {
      "id": "pc_7HfK2wQe9TzB4nLx0sVdMa",
      "application_id": "pa_3kTq9ZxV1bN7cR2mW8yLpA",
      "application_reference": "2026/4417/P",
      "authority": "Camden",
      "condition_number": "4",
      "condition_text": "Prior to first occupation, a Travel Plan shall be submitted to and approved in writing by the local planning authority.",
      "reason": "To promote sustainable modes of transport.",
      "disciplines": [
        "transport"
      ],
      "decided_date": "2026-09-22",
      "source_pdf_url": "https://planning.example-council.gov.uk/documents/2026-4417-P-decision.pdf",
      "created_at": "2026-09-23T06:12:44.000Z"
    }
  ],
  "next_cursor": null
}

Errors

Every error has the same JSON shape: { "error": "...", "code": "..." }, with extra fields on some codes. Full bodies are on rate limits and errors.

{
  "error": "The conditions endpoints are part of API Pro.",
  "code": "plan_required",
  "upgrade_url": "https://planningsignal.co.uk/developers#pricing"
}