API reference
All responses are JSON: { data, meta, attribution }. Base URL https://agent-data-platform.langtools.workers.dev. Paid endpoints use x402; see how payment works.
NSW Development Applications
Development applications lodged through the NSW Planning Portal: status, dates, cost, dwellings, development types and geocoded addresses. Synced from the source several times a day.
Base path /v1/nsw-da · Markdown: /docs/nsw-da.md
GET /v1/nsw-da/summary
Get counts of NSW development applications by status, application type and council. Call it before nsw_da_search_applications or nsw_da_search_nearby_applications: it returns the total loaded and by_status, by_application_type and by_council lists of { key, count }, whose keys are the exact filter values those tools accept. Filters are optional and combine with AND; without them the counts cover all of NSW. Counts refresh every 6 hours while the history backfill extends coverage back to 2021.
Price: free · MCP tool: nsw_da_get_summary
| Param | In | Required | Description | Example |
|---|---|---|---|---|
council | query | no | Council name or part of it, case-insensitive; matches every council whose name contains it. Full names are in by_council of nsw_da_get_summary | Parramatta |
status | query | no | Application status, exact and case-sensitive; valid values are the keys of by_status in nsw_da_get_summary | Determined |
application_type | query | no | Application type, exact and case-sensitive; valid values are the keys of by_application_type in nsw_da_get_summary | Development Application |
GET /v1/nsw-da/applications
Search NSW development applications by council, suburb, postcode or lodgement date, newest lodgement first. Returns up to 100 development applications per call with address, status, cost, dwellings, storeys and development types, plus has_more for paging with offset. status, application_type, development_type and min_cost must be combined with council, suburb or postcode. Use get_application for the full record of a result.
Price: $0.01 per call (x402, USDC) · MCP tool: nsw_da_search_applications
| Param | In | Required | Description | Example |
|---|---|---|---|---|
council | query | no | Council name or part of it, case-insensitive; matches every council whose name contains it. Full names are in by_council of nsw_da_get_summary | Parramatta |
suburb | query | no | Suburb of the primary address, case-insensitive | ERMINGTON |
postcode | query | no | 4-digit postcode of the primary address | 2115 |
lodged_from | query | no | Lodgement date lower bound, yyyy-mm-dd | 2026-01-01 |
lodged_to | query | no | Lodgement date upper bound, yyyy-mm-dd | 2026-06-30 |
status | query | no | Application status, exact and case-sensitive; valid values are the keys of by_status in nsw_da_get_summary | Determined |
application_type | query | no | Application type, exact and case-sensitive; valid values are the keys of by_application_type in nsw_da_get_summary | Development Application |
development_type | query | no | Development type, partial match | dwelling |
min_cost | query | no | Minimum estimated cost of development in AUD | 1000000 |
limit | query | no | Page size, 1-100 (default 20) | |
offset | query | no | Number of results to skip, 0-1000 (default 0) |
GET /v1/nsw-da/applications/:pan
Get the full record of one of the NSW development applications by its Planning Portal application number (PAN). Returns every location with lot and plan, all development types, submission, lodgement, determination and exhibition dates, cost, dwellings, storeys, lots and the remaining source fields. Take PAN numbers from search_applications or search_nearby_applications. An unknown number returns not_found and is not charged.
Price: $0.005 per call (x402, USDC) · MCP tool: nsw_da_get_application
| Param | In | Required | Description | Example |
|---|---|---|---|---|
pan | path | yes | Planning Portal application number (PAN) | PAN-624302 |
GET /v1/nsw-da/nearby
Find NSW development applications within 2 km of a street address or latitude/longitude, nearest first. Pass address (e.g. '10 Brigalow Ave, Casula') and it is geocoded against the official NSW address register, or pass lat and lng. Returns the distance in metres for each result plus the same fields as search_applications; meta.geocode shows the matched address. An unknown or ambiguous address returns an error with suggestions and is not charged. lodged_from limits results to recent applications.
Price: $0.02 per call (x402, USDC) · MCP tool: nsw_da_search_nearby_applications
| Param | In | Required | Description | Example |
|---|---|---|---|---|
address | query | no | NSW street address with suburb; alternative to lat/lng | 10 Brigalow Ave, Casula NSW 2170 |
lat | query | no | Latitude (WGS84); required unless address is given | -33.81 |
lng | query | no | Longitude (WGS84); required unless address is given | 151.06 |
radius_m | query | no | Radius in metres, 1-2000 (default 500) | |
lodged_from | query | no | Lodgement date lower bound, yyyy-mm-dd | |
limit | query | no | Max results, 1-100 (default 20) |
GET /v1/nsw-da/address
Resolve a NSW street address to its official form and latitude/longitude. Matches the address against the NSW address register and returns matched_address, lat and lng. Use it to check an address before nsw_da_search_nearby_applications, nsw_cdc_search_nearby_applications or nsw_property_get_planning_report, which accept the same address or the returned lat and lng. An ambiguous address returns an error with suggested matches; an unknown one returns address_not_found.
Price: free · MCP tool: nsw_da_resolve_address
| Param | In | Required | Description | Example |
|---|---|---|---|---|
address | query | yes | Street number, street and suburb; a trailing state and postcode are accepted and ignored | 10 Brigalow Ave, Casula NSW 2170 |
Attribution: Contains data from the NSW Planning Portal Online DA Data API, © State of New South Wales, licensed under CC BY 4.0. Licence
NSW Complying Development Certificates
Complying development certificates (CDCs) lodged through the NSW Planning Portal, the fast-track approval used for many new houses, granny flats, extensions and pools: status, dates, cost, dwellings, building classes, certifier and geocoded addresses. Synced from the source several times a day.
Base path /v1/nsw-cdc · Markdown: /docs/nsw-cdc.md
GET /v1/nsw-cdc/summary
Get counts of NSW complying development certificates (CDCs) by status, application type and council. Call it before nsw_cdc_search_applications or nsw_cdc_search_nearby_applications: it returns the total loaded and by_status, by_application_type and by_council lists of { key, count }, whose keys are the exact filter values those tools accept. Filters are optional and combine with AND; without them the counts cover all of NSW. Counts refresh every 6 hours while the history backfill extends coverage back to 2021.
Price: free · MCP tool: nsw_cdc_get_summary
| Param | In | Required | Description | Example |
|---|---|---|---|---|
council | query | no | Council name or part of it, case-insensitive; matches every council whose name contains it. Full names are in by_council of nsw_cdc_get_summary | Parramatta |
status | query | no | Application status, exact and case-sensitive; valid values are the keys of by_status in nsw_cdc_get_summary | Approved |
application_type | query | no | Application type, exact and case-sensitive; valid values are the keys of by_application_type in nsw_cdc_get_summary | Complying Development Certificate Application |
GET /v1/nsw-cdc/applications
Search NSW complying development certificates (CDCs) by council, suburb, postcode or lodgement date, newest lodgement first. Returns up to 100 complying development certificates (CDCs) per call with address, status, cost, dwellings, storeys and development types, plus has_more for paging with offset. status, application_type, development_type and min_cost must be combined with council, suburb or postcode. Use get_application for the full record of a result.
Price: $0.01 per call (x402, USDC) · MCP tool: nsw_cdc_search_applications
| Param | In | Required | Description | Example |
|---|---|---|---|---|
council | query | no | Council name or part of it, case-insensitive; matches every council whose name contains it. Full names are in by_council of nsw_cdc_get_summary | Parramatta |
suburb | query | no | Suburb of the primary address, case-insensitive | ERMINGTON |
postcode | query | no | 4-digit postcode of the primary address | 2115 |
lodged_from | query | no | Lodgement date lower bound, yyyy-mm-dd | 2026-01-01 |
lodged_to | query | no | Lodgement date upper bound, yyyy-mm-dd | 2026-06-30 |
status | query | no | Application status, exact and case-sensitive; valid values are the keys of by_status in nsw_cdc_get_summary | Approved |
application_type | query | no | Application type, exact and case-sensitive; valid values are the keys of by_application_type in nsw_cdc_get_summary | Complying Development Certificate Application |
development_type | query | no | Development type, partial match | dwelling |
min_cost | query | no | Minimum estimated cost of development in AUD | 1000000 |
limit | query | no | Page size, 1-100 (default 20) | |
offset | query | no | Number of results to skip, 0-1000 (default 0) |
GET /v1/nsw-cdc/applications/:cdc
Get the full record of one of the NSW complying development certificates (CDCs) by its Planning Portal CDC number. Returns every location with lot and plan, all development types, submission, lodgement, determination and exhibition dates, cost, dwellings, storeys, lots and the remaining source fields. Take CDC numbers from search_applications or search_nearby_applications. An unknown number returns not_found and is not charged.
Price: $0.005 per call (x402, USDC) · MCP tool: nsw_cdc_get_application
| Param | In | Required | Description | Example |
|---|---|---|---|---|
cdc | path | yes | Planning Portal CDC number | CDC-388198 |
GET /v1/nsw-cdc/nearby
Find NSW complying development certificates (CDCs) within 2 km of a street address or latitude/longitude, nearest first. Pass address (e.g. '10 Brigalow Ave, Casula') and it is geocoded against the official NSW address register, or pass lat and lng. Returns the distance in metres for each result plus the same fields as search_applications; meta.geocode shows the matched address. An unknown or ambiguous address returns an error with suggestions and is not charged. lodged_from limits results to recent applications.
Price: $0.02 per call (x402, USDC) · MCP tool: nsw_cdc_search_nearby_applications
| Param | In | Required | Description | Example |
|---|---|---|---|---|
address | query | no | NSW street address with suburb; alternative to lat/lng | 10 Brigalow Ave, Casula NSW 2170 |
lat | query | no | Latitude (WGS84); required unless address is given | -33.81 |
lng | query | no | Longitude (WGS84); required unless address is given | 151.06 |
radius_m | query | no | Radius in metres, 1-2000 (default 500) | |
lodged_from | query | no | Lodgement date lower bound, yyyy-mm-dd | |
limit | query | no | Max results, 1-100 (default 20) |
Attribution: Contains data from the NSW Planning Portal Online CDC Data API, © State Government of NSW and NSW Department of Planning, Housing and Infrastructure, licensed under CC BY 4.0. Licence
NSW Property Planning Report
One-call answers for a NSW address: a planning report (lot and plan, zoning, maximum building height, floor space ratio, minimum lot size, heritage and special planning areas such as the Greenfield Housing Code, plus the development applications and CDCs on the site and nearby) and a summary of the development activity around it.
Base path /v1/nsw-property · Markdown: /docs/nsw-property.md
GET /v1/nsw-property/report
Get the planning controls, lot and development applications for a NSW address in one call. Pass address (e.g. '5A Atkins Rd, Ermington') or lat and lng. Returns the lot and plan, zoning, maximum building height, floor space ratio, minimum lot size, heritage listings and special planning areas, each linked to its planning instrument, plus development applications and CDCs on the site and within radius_m (default 200, max 500), 10 of each, nearest first. Council DCP controls such as setbacks are not included. An unknown or ambiguous address returns an error with suggestions and is not charged.
Price: $0.05 per call (x402, USDC) · MCP tool: nsw_property_get_planning_report
| Param | In | Required | Description | Example |
|---|---|---|---|---|
address | query | no | NSW street address with suburb | 5A Atkins Rd, Ermington |
lat | query | no | Latitude, instead of address | |
lng | query | no | Longitude, instead of address | |
radius_m | query | no | Radius for nearby applications in metres (default 200, max 500) |
GET /v1/nsw-property/activity
Get what is being built near a NSW address: development applications and CDCs, summarised. Answers questions such as "what is being built near this address" in one call. Pass address or lat and lng. Merges development applications and complying development certificates lodged within radius_m (default 500, max 2000) in the last months (default 24, max 120) and returns totals (applications, new dwellings, total cost), counts by status, development type and year, the 5 largest by cost, and the newest limit applications (default 20, max 50) with distance, status, cost and dates. Use nsw_property_get_planning_report for the zoning and controls of the site itself, and nsw_da_get_application or nsw_cdc_get_application for one record in full. capped is true when more than 2000 records of one kind matched; the summary then covers the nearest ones. An unknown or ambiguous address returns an error with suggestions and is not charged.
Price: $0.03 per call (x402, USDC) · MCP tool: nsw_property_get_development_activity
| Param | In | Required | Description | Example |
|---|---|---|---|---|
address | query | no | Street number, street and suburb; or pass lat and lng | 5A Atkins Rd, Ermington |
lat | query | no | Latitude in decimal degrees, instead of address | |
lng | query | no | Longitude in decimal degrees, instead of address | |
radius_m | query | no | Search radius in metres, 1-2000 (default 500) | |
months | query | no | Lodgement window in months back from today, 1-120 (default 24) | |
limit | query | no | Newest applications to list, 1-50 (default 20); totals cover all matches |
Attribution: Planning controls from the NSW Planning Portal EPI Primary Planning Layers, NSW Crown Copyright – Department of Planning and Environment, CC BY 3.0 AU. Lot and address data © State of New South Wales (Spatial Services), CC BY 4.0. Applications from the NSW Planning Portal Online DA and CDC Data APIs, © State of New South Wales, CC BY 4.0. Licence