API Reference

Complete reference documentation for the Council DA API.

Base URL:https://api.council-da.com/v1

Authentication

All API requests require authentication using an API key. Include your key in the X-API-Key header.

curl -X GET "https://api.council-da.com/v1/applications" \
  -H "X-API-Key: your_api_key"

Applications

Query development applications from councils across Australia

GET/v1/applications

List applications with filtering and pagination

Parameters

Name	Type	Required	Description
`council`	string	No	Filter by council code (e.g., "BRISBANE", "SYDNEY")
`status`	string	No	Filter by status: lodged, under_assessment, approved, refused
`suburb`	string	No	Filter by suburb name
`state`	string	No	Filter by state: NSW, VIC, QLD, SA, WA, TAS, NT, ACT
`category`	string	No	Filter by category: residential, commercial, industrial
`lodged_after`	string	No	Filter applications lodged after this date (YYYY-MM-DD)
`lodged_before`	string	No	Filter applications lodged before this date (YYYY-MM-DD)
`min_cost`	integer	No	Minimum estimated cost filter
`max_cost`	integer	No	Maximum estimated cost filter
`page`	integer	No	Page number (default: 1)
`per_page`	integer	No	Results per page (default: 50, max: 100)

Response

{
  "data": [
    {
      "id": "uuid",
      "da_number": "DA-2024-1234",
      "address": "123 Main Street, Sydney NSW 2000",
      "suburb": "Sydney",
      "state": "NSW",
      "postcode": "2000",
      "council_code": "SYDNEY",
      "council_name": "City of Sydney",
      "description": "Construction of a two-storey residential dwelling",
      "category": "residential",
      "status": "under_assessment",
      "lodged_date": "2024-12-01",
      "estimated_cost": 450000,
      "dwelling_count": 1
    }
  ],
  "total": 1250,
  "page": 1,
  "per_page": 50,
  "total_pages": 25
}

GET/v1/applications/nearby

Geographic radius search — return every development application within a given distance of a lat/lng point, ordered nearest-first. Backed by PostGIS; each result includes its distance and coordinates. ~83% of applications are geocoded (the rest have no coordinates and won't appear in radius results).

Parameters

Name	Type	Required	Description
`lat`	float	Yes	Latitude of the search centre (-90 to 90)
`lng`	float	Yes	Longitude of the search centre (-180 to 180)
`radius_km`	float	No	Search radius in kilometres (0.1 to 50, default 5). For a tight property-level search use 0.2–0.5 (200–500m).
`page`	integer	No	Page number (default: 1)
`per_page`	integer	No	Results per page (default: 50, max: 100)

Response

{
  "data": [
    {
      "id": "uuid",
      "da_number": "DA-2024-0892",
      "address": "32 Smith Street, Parramatta NSW 2150",
      "suburb": "Parramatta",
      "state": "NSW",
      "council_name": "City of Parramatta",
      "category": "residential",
      "status": "under_assessment",
      "lodged_date": "2024-03-15",
      "estimated_cost": 1250000,
      "distance_km": 0.18,
      "lat": -33.8136,
      "lng": 151.0034
    }
  ],
  "total": 47,
  "page": 1,
  "per_page": 50,
  "total_pages": 1,
  "search_point": { "lat": -33.8136, "lng": 151.0034, "radius_km": 0.5 }
}

GET/v1/applications/{id}

Get a specific application by ID

Parameters

Name	Type	Required	Description
`id`	string	Yes	Application UUID

Response

{
  "id": "uuid",
  "da_number": "DA-2024-1234",
  "address": "123 Main Street, Sydney NSW 2000",
  "estimated_cost": 450000,
  "dwelling_count": 1,
  "storeys": 2,
  "car_spaces": 2,
  ...
}

GET/v1/applications/{id}/enriched

Get application with property market data and nearby professionals (UNIQUE)

Parameters

Name	Type	Required	Description
`id`	string	Yes	Application UUID

Response

{
  "application": { ... },
  "property_market": {
    "sales_last_12m": 45,
    "median_price": 1250000,
    "average_price": 1380000
  },
  "nearby_professionals": [
    {
      "id": 1234,
      "abn": "12345678901",
      "legal_name": "ABC Builders Pty Ltd",
      "category": "Builder/Construction"
    }
  ],
  "professionals_count": 10
}

GET/v1/applications/{id}/leads

Get applicant→builder/company leads matched to a DA's applicant — ABN, business name, phone, email and website for the party behind the application (Professional plans and above)

Parameters

Name	Type	Required	Description
`id`	string	Yes	Application UUID

Response

{
  "applicant_name": "John Smith Developments Pty Ltd",
  "leads_count": 1,
  "leads": [
    {
      "abn": "12345678901",
      "business_name": "John Smith Developments Pty Ltd",
      "phone": "+61 2 9000 0000",
      "email": "contact@jsdevelopments.com.au",
      "website": "https://jsdevelopments.com.au",
      "state": "NSW"
    }
  ]
}

Rate Limits

API rate limits depend on your subscription plan:

Plan	Daily Requests	Rate Limit	Historical Data
Starter	500/day	60 req/min	2 years
Professional	2,000/day	120 req/min	36 years
Business	10,000/day	240 req/min	36 years
Enterprise	Custom	Custom	Custom

Rate limit headers are included in every response: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset