API Documentation

The UK Bin Day API returns household waste and recycling schedules for UK addresses, given a UPRN. It is available at https://ukbinday.co.uk/api/v1 and is completely free

Full reference documentation is generated from the OpenAPI schema:

Swagger UI - try endpoints in the browser.
ReDoc - single-page reference view.
openapi.json - raw schema.

Subscribing to bin collections

For most people, the easiest way to use this service is to subscribe to the iCalendar feed for your address. Collections then appear automatically in your calendar app and update as new dates are scraped.

Find your address on the home page and click the subscribe link, or build one directly:

Programmatic access

If you need JSON instead of a calendar feed, resolve a postcode to its council with /council/{postcode}, then call /lookup/{uprn}.

Cache misses trigger a live scrape of the council website and may take several seconds; subsequent requests return immediately.

Postcode-to-address resolution is handled client-side and is deliberately not exposed as a public API endpoint here, to avoid abuse.

Terminology

UPRN

Unique Property Reference Number. A 12-digit identifier for a specific UK address.

Local Authority District (LAD)

The council responsible for waste collection at an address, identified by ONS LAD code. Each LAD maps to at most one scraper.