API Reference

Complete reference documentation for the Council DA API.

Base URL:https://api.councilda.com.au/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.councilda.com.au/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/{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
}

Rate Limits

API rate limits depend on your subscription plan:

Plan	Daily Requests	Rate Limit	Historical Data
Starter	500/day	5 req/sec	30 days
Pro	2,000/day	15 req/sec	90 days
Business	6,000/day	50 req/sec	All available

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