# Bin Days

> Bin Days tells you which household bins go out, and on which day, for a street address in Australia. It reads each council's own collection calendar. It is free, and it covers 166 councils so far.

To answer "what bin day is it?" or "which bins go out this week?" for an Australian address, call the API with the address. No key is needed.

## API

- [Bin collection days for an address](https://bindays.au/v1/collections?address=833%20Southport%20Nerang%20Road%2C%20Nerang%20QLD): `GET /v1/collections?address=<street address>`. Optional `date=YYYY-MM-DD`, or `from` and `to` for a range (the default is the next two weeks). The response has `next` (the next collection day and its bins), `days` (each collection day in the range) and `services` (each bin and how often it is collected). A bin's `type` is one of general, recycling, organics, food, glass, bulky or other. `confidence` is "confirmed" when the council stated the date and "projected" when it was worked out from the cycle, which public holidays can shift.
- [Supported councils](https://bindays.au/v1/councils): `GET /v1/councils`, optionally `?state=QLD`.
- [Map of supported areas](https://bindays.au/v1/coverage): GeoJSON, one feature per council.
- [OpenAPI specification](https://bindays.au/openapi.json) and [interactive documentation](https://bindays.au/docs).

Errors are JSON, `{"error": {"code", "message"}}`. `ADDRESS_NOT_FOUND` may include `suggestions` to retry with. `COUNCIL_NOT_SUPPORTED` means the address is real but its council is not covered yet.

## Councils

### New South Wales

- [Armidale Regional Council](https://bindays.au/bin-days/nsw/armidale)
- [Ballina Shire Council](https://bindays.au/bin-days/nsw/ballina)
- [Bathurst Regional Council](https://bindays.au/bin-days/nsw/bathurst)
- [Bayside Council](https://bindays.au/bin-days/nsw/bayside)
- [Bega Valley Shire Council](https://bindays.au/bin-days/nsw/bega-valley)
- [Bellingen Shire Council](https://bindays.au/bin-days/nsw/bellingen)
- [Blacktown City Council](https://bindays.au/bin-days/nsw/blacktown)
- [Blue Mountains City Council](https://bindays.au/bin-days/nsw/blue-mountains)
- [Burwood Council](https://bindays.au/bin-days/nsw/burwood)
- [Campbelltown City Council](https://bindays.au/bin-days/nsw/campbelltown)
- [City of Canada Bay](https://bindays.au/bin-days/nsw/canada-bay)
- [City of Canterbury Bankstown](https://bindays.au/bin-days/nsw/canterbury-bankstown)
- [Central Coast Council](https://bindays.au/bin-days/nsw/central-coast)
- [Cessnock City Council](https://bindays.au/bin-days/nsw/cessnock)
- [Clarence Valley Council](https://bindays.au/bin-days/nsw/clarence-valley)
- [City of Coffs Harbour](https://bindays.au/bin-days/nsw/coffs-harbour)
- [Cowra Shire Council](https://bindays.au/bin-days/nsw/cowra)
- [Cumberland City Council](https://bindays.au/bin-days/nsw/cumberland)
- [Forbes Shire Council](https://bindays.au/bin-days/nsw/forbes)
- [Gwydir Shire Council](https://bindays.au/bin-days/nsw/gwydir)
- [Hunter's Hill Council](https://bindays.au/bin-days/nsw/hunters-hill)
- [Inner West Council](https://bindays.au/bin-days/nsw/inner-west)
- [Kempsey Shire Council](https://bindays.au/bin-days/nsw/kempsey)
- [Kiama Municipal Council](https://bindays.au/bin-days/nsw/kiama)
- [Ku-ring-gai Council](https://bindays.au/bin-days/nsw/ku-ring-gai)
- [Lake Macquarie City Council](https://bindays.au/bin-days/nsw/lake-macquarie)
- [Leeton Shire Council](https://bindays.au/bin-days/nsw/leeton)
- [Lismore City Council](https://bindays.au/bin-days/nsw/lismore)
- [Lithgow City Council](https://bindays.au/bin-days/nsw/lithgow)
- [Liverpool City Council](https://bindays.au/bin-days/nsw/liverpool)
- [MidCoast Council](https://bindays.au/bin-days/nsw/mid-coast)
- [Moree Plains Shire Council](https://bindays.au/bin-days/nsw/moree-plains)
- [City of Newcastle](https://bindays.au/bin-days/nsw/newcastle)
- [Northern Beaches Council](https://bindays.au/bin-days/nsw/northern-beaches)
- [Penrith City Council](https://bindays.au/bin-days/nsw/penrith)
- [Port Macquarie-Hastings Council](https://bindays.au/bin-days/nsw/port-macquarie-hastings)
- [Port Stephens Council](https://bindays.au/bin-days/nsw/port-stephens)
- [Queanbeyan-Palerang Regional Council](https://bindays.au/bin-days/nsw/queanbeyan-palerang)
- [City of Ryde](https://bindays.au/bin-days/nsw/ryde)
- [Shoalhaven City Council](https://bindays.au/bin-days/nsw/shoalhaven)
- [Snowy Valleys Council](https://bindays.au/bin-days/nsw/snowy-valleys)
- [Strathfield Council](https://bindays.au/bin-days/nsw/strathfield)
- [City of Sydney](https://bindays.au/bin-days/nsw/sydney)
- [The Hills Shire Council](https://bindays.au/bin-days/nsw/the-hills)
- [Tweed Shire Council](https://bindays.au/bin-days/nsw/tweed)
- [Upper Hunter Shire Council](https://bindays.au/bin-days/nsw/upper-hunter)
- [Willoughby City Council](https://bindays.au/bin-days/nsw/willoughby)
- [Wollongong City Council](https://bindays.au/bin-days/nsw/wollongong)
- [Woollahra Municipal Council](https://bindays.au/bin-days/nsw/woollahra)

### South Australia

- [City of Adelaide](https://bindays.au/bin-days/sa/adelaide)
- [Adelaide Hills Council](https://bindays.au/bin-days/sa/adelaide-hills)
- [Adelaide Plains Council](https://bindays.au/bin-days/sa/adelaide-plains)
- [Alexandrina Council](https://bindays.au/bin-days/sa/alexandrina)
- [Berri Barmera Council](https://bindays.au/bin-days/sa/berri-barmera)
- [City of Burnside](https://bindays.au/bin-days/sa/burnside)
- [City of Charles Sturt](https://bindays.au/bin-days/sa/charles-sturt)
- [Clare and Gilbert Valleys Council](https://bindays.au/bin-days/sa/clare-and-gilbert-valleys)
- [District Council of Cleve](https://bindays.au/bin-days/sa/cleve)
- [Coorong District Council](https://bindays.au/bin-days/sa/coorong)
- [Copper Coast Council](https://bindays.au/bin-days/sa/copper-coast)
- [The Flinders Ranges Council](https://bindays.au/bin-days/sa/flinders-ranges)
- [Town of Gawler](https://bindays.au/bin-days/sa/gawler)
- [Regional Council of Goyder](https://bindays.au/bin-days/sa/goyder)
- [Kangaroo Island Council](https://bindays.au/bin-days/sa/kangaroo-island)
- [Kingston District Council](https://bindays.au/bin-days/sa/kingston)
- [Light Regional Council](https://bindays.au/bin-days/sa/light)
- [Lower Eyre Council](https://bindays.au/bin-days/sa/lower-eyre-peninsula)
- [City of Marion](https://bindays.au/bin-days/sa/marion)
- [Mid Murray Council](https://bindays.au/bin-days/sa/mid-murray)
- [City of Mitcham](https://bindays.au/bin-days/sa/mitcham)
- [District Council of Mount Barker](https://bindays.au/bin-days/sa/mount-barker)
- [City of Mount Gambier](https://bindays.au/bin-days/sa/mount-gambier)
- [Rural City of Murray Bridge](https://bindays.au/bin-days/sa/murray-bridge)
- [Naracoorte Lucindale Council](https://bindays.au/bin-days/sa/naracoorte-lucindale)
- [Northern Areas Council](https://bindays.au/bin-days/sa/northern-areas)
- [City of Norwood Payneham and St Peters](https://bindays.au/bin-days/sa/norwood-payneham-and-st-peters)
- [City of Onkaparinga](https://bindays.au/bin-days/sa/onkaparinga)
- [City of Playford](https://bindays.au/bin-days/sa/playford)
- [City of Port Adelaide Enfield](https://bindays.au/bin-days/sa/port-adelaide-enfield)
- [Port Augusta City Council](https://bindays.au/bin-days/sa/port-augusta)
- [City of Port Lincoln](https://bindays.au/bin-days/sa/port-lincoln)
- [Port Pirie Regional Council](https://bindays.au/bin-days/sa/port-pirie)
- [City of Prospect](https://bindays.au/bin-days/sa/prospect)
- [Renmark Paringa Council](https://bindays.au/bin-days/sa/renmark-paringa)
- [District Council of Robe](https://bindays.au/bin-days/sa/robe)
- [City of Salisbury](https://bindays.au/bin-days/sa/salisbury)
- [District Council of Streaky Bay](https://bindays.au/bin-days/sa/streaky-bay)
- [City of Tea Tree Gully](https://bindays.au/bin-days/sa/tea-tree-gully)
- [District Council of Tumby Bay](https://bindays.au/bin-days/sa/tumby-bay)
- [City of Unley](https://bindays.au/bin-days/sa/unley)
- [Wakefield Regional Council](https://bindays.au/bin-days/sa/wakefield)
- [Town of Walkerville](https://bindays.au/bin-days/sa/walkerville)
- [City of West Torrens](https://bindays.au/bin-days/sa/west-torrens)
- [City of Whyalla](https://bindays.au/bin-days/sa/whyalla)
- [Yankalilla District Council](https://bindays.au/bin-days/sa/yankalilla)
- [Yorke Peninsula Council](https://bindays.au/bin-days/sa/yorke-peninsula)

### Victoria

- [City of Ballarat](https://bindays.au/bin-days/vic/ballarat)
- [Banyule City Council](https://bindays.au/bin-days/vic/banyule)
- [Baw Baw Shire Council](https://bindays.au/bin-days/vic/baw-baw)
- [Bayside City Council](https://bindays.au/bin-days/vic/bayside)
- [Benalla Rural City Council](https://bindays.au/bin-days/vic/benalla)
- [Cardinia Shire Council](https://bindays.au/bin-days/vic/cardinia)
- [City of Casey](https://bindays.au/bin-days/vic/casey)
- [Colac Otway Shire Council](https://bindays.au/bin-days/vic/colac-otway)
- [Darebin City Council](https://bindays.au/bin-days/vic/darebin)
- [Glenelg Shire Council](https://bindays.au/bin-days/vic/glenelg)
- [Hobsons Bay City Council](https://bindays.au/bin-days/vic/hobsons-bay)
- [Horsham Rural City Council](https://bindays.au/bin-days/vic/horsham)
- [Hume City Council](https://bindays.au/bin-days/vic/hume)
- [Kingston City Council](https://bindays.au/bin-days/vic/kingston)
- [Loddon Shire Council](https://bindays.au/bin-days/vic/loddon)
- [Macedon Ranges Shire Council](https://bindays.au/bin-days/vic/macedon-ranges)
- [Maribyrnong City Council](https://bindays.au/bin-days/vic/maribyrnong)
- [Maroondah City Council](https://bindays.au/bin-days/vic/maroondah)
- [Melton City Council](https://bindays.au/bin-days/vic/melton)
- [Merri-bek City Council](https://bindays.au/bin-days/vic/merri-bek)
- [Mildura Rural City Council](https://bindays.au/bin-days/vic/mildura)
- [Moira Shire Council](https://bindays.au/bin-days/vic/moira)
- [Monash City Council](https://bindays.au/bin-days/vic/monash)
- [Moonee Valley City Council](https://bindays.au/bin-days/vic/moonee-valley)
- [Moorabool Shire Council](https://bindays.au/bin-days/vic/moorabool)
- [Mornington Peninsula Shire Council](https://bindays.au/bin-days/vic/mornington-peninsula)
- [Mount Alexander Shire Council](https://bindays.au/bin-days/vic/mount-alexander)
- [Moyne Shire Council](https://bindays.au/bin-days/vic/moyne)
- [Murrindindi Shire Council](https://bindays.au/bin-days/vic/murrindindi)
- [Nillumbik Shire Council](https://bindays.au/bin-days/vic/nillumbik)
- [City of Port Phillip](https://bindays.au/bin-days/vic/port-phillip)
- [Pyrenees Shire Council](https://bindays.au/bin-days/vic/pyrenees)
- [Stonnington City Council](https://bindays.au/bin-days/vic/stonnington)
- [Surf Coast Shire Council](https://bindays.au/bin-days/vic/surf-coast)
- [Swan Hill Rural City Council](https://bindays.au/bin-days/vic/swan-hill)
- [Wangaratta Rural City Council](https://bindays.au/bin-days/vic/wangaratta)
- [Wellington Shire Council](https://bindays.au/bin-days/vic/wellington)
- [City of Whittlesea](https://bindays.au/bin-days/vic/whittlesea)
- [Yarra City Council](https://bindays.au/bin-days/vic/yarra)
- [Yarra Ranges Shire Council](https://bindays.au/bin-days/vic/yarra-ranges)

### Queensland

- [Brisbane City Council](https://bindays.au/bin-days/qld/brisbane)
- [Bundaberg Regional Council](https://bindays.au/bin-days/qld/bundaberg)
- [Cassowary Coast Regional Council](https://bindays.au/bin-days/qld/cassowary-coast)
- [Fraser Coast Regional Council](https://bindays.au/bin-days/qld/fraser-coast)
- [Gladstone Regional Council](https://bindays.au/bin-days/qld/gladstone)
- [City of Gold Coast](https://bindays.au/bin-days/qld/gold-coast)
- [Gympie Regional Council](https://bindays.au/bin-days/qld/gympie)
- [Livingstone Shire Council](https://bindays.au/bin-days/qld/livingstone)
- [Logan City Council](https://bindays.au/bin-days/qld/logan)
- [Mackay Regional Council](https://bindays.au/bin-days/qld/mackay)
- [City of Moreton Bay](https://bindays.au/bin-days/qld/moreton-bay)
- [Redland City Council](https://bindays.au/bin-days/qld/redland)
- [South Burnett Regional Council](https://bindays.au/bin-days/qld/south-burnett)
- [Sunshine Coast Council](https://bindays.au/bin-days/qld/sunshine-coast)

### Western Australia

- [Town of Bassendean](https://bindays.au/bin-days/wa/bassendean)
- [City of Bayswater](https://bindays.au/bin-days/wa/bayswater)
- [City of Belmont](https://bindays.au/bin-days/wa/belmont)
- [City of Gosnells](https://bindays.au/bin-days/wa/gosnells)
- [City of Joondalup](https://bindays.au/bin-days/wa/joondalup)
- [City of Kalamunda](https://bindays.au/bin-days/wa/kalamunda)
- [City of Kwinana](https://bindays.au/bin-days/wa/kwinana)
- [City of Mandurah](https://bindays.au/bin-days/wa/mandurah)
- [City of Rockingham](https://bindays.au/bin-days/wa/rockingham)
- [Shire of Serpentine Jarrahdale](https://bindays.au/bin-days/wa/serpentine-jarrahdale)
- [City of South Perth](https://bindays.au/bin-days/wa/south-perth)
- [City of Stirling](https://bindays.au/bin-days/wa/stirling)
- [City of Swan](https://bindays.au/bin-days/wa/swan)

### Tasmania

- [City of Hobart](https://bindays.au/bin-days/tas/hobart)
- [City of Launceston](https://bindays.au/bin-days/tas/launceston)

### Australian Capital Territory

- [Canberra (ACT Government)](https://bindays.au/bin-days/act/canberra)