Get Planning History
get_planning_historyPurpose: retrieve a bounded national planning-application sample for a resolved England site. When to use: for first-pass record research with direct local-portal verification. Returns: references, source decision text, known/unknown outcomes, nullable dates, source-point proximity, source state and coverage limits. Limitations: not a current complete local register; national data origin, council coverage and freshness remain unverified. Failed sources return unknown counts, not zero; other jurisdictions require their local registers. No implied approval or absence of applications. Parameter guidance: use an England address or resolved reference, radius 250–1000m, limit 1–20, and optional outcome filter; filtering applies to the returned bounded sample. Chaining: every response returns site_ref; pass it unchanged into another Atlasly tool to reuse the canonical site, coordinates, boundary confidence, LPA, evidence links, and project context.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_planning_history"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| address | No | Site address or postcode | |
| site_ref | No | Canonical site_ref returned by any previous Atlasly tool. Pass it unchanged to chain the same resolved site into this call; address, search_area, or project_id will be filled from it when omitted. | |
| radius_meters | No | Search radius in metres around the site. Requests above the caller's limit (1,000 m without an account, 2,000 m with one) are reduced or rejected. | |
| outcome_filter | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | No | ||
| status | Yes | ||
| details | No | ||
| message | No | ||
| sources | Yes | ||
| headline | Yes | ||
| site_ref | Yes | ||
| retryable | No | ||
| error_code | No | ||
| atlasly_link | Yes | ||
| error_source | No | ||
| human_message | No | ||
| key_data_points | Yes | ||
| top_constraints | Yes | ||
| confidence_notes | Yes | ||
| executive_summary | Yes | ||
| next_best_actions | Yes | ||
| top_opportunities | Yes |