Gov APImy.cheshirewestandchester.gov.uk ↗
Look up household bin collection schedules for any address in Cheshire West and Chester. Search by postcode, resolve UPRNs, and retrieve waste service dates.
What is the Gov API?
This API provides 2 endpoints for looking up household waste collection schedules across the Cheshire West and Chester council area. Use search_addresses to find properties by postcode and retrieve their UPRN identifiers, then call get_bin_schedule to retrieve assigned waste services and a full dated list of past and upcoming collection events, including recycling, domestic, food, and garden waste rounds.
curl -X GET 'https://api.parse.bot/scraper/b086cece-f464-4882-82ae-992302b74798/search_addresses?postcode=CH2+3HX' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace my-cheshirewestandchester-gov-uk-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: CheshireWestBins SDK — bounded, re-runnable; every call capped."""
from parse_apis.Cheshire_West_and_Chester_Bin_Collections_API import CheshireWestBins, ParseError
client = CheshireWestBins()
# Search for addresses in a postcode
for address in client.addresses.search(postcode="CH2 3HX", limit=3):
print(address.display, address.uprn)
# Take the first address and look up its bin schedule
addr = client.addresses.search(postcode="CH2 3HX", limit=1).first()
try:
schedule = client.bin_schedules.get(uprn=addr.uprn, from_date="2026-07-01")
print("Services for", addr.display)
for svc in schedule.services:
print(f" {svc.service}: {svc.service_type} every {svc.calendar}")
for col in schedule.collections[:3]:
print(f" {col.collection_date} - {col.service_type} ({col.status})")
except ParseError as e:
print(f"Error: {e}")
print("exercised: addresses.search, bin_schedules.get")
Search for addresses within a postcode in the Cheshire West and Chester council area. Returns a list of addresses with their UPRN identifiers, which are needed to look up bin collection schedules.
| Param | Type | Description |
|---|---|---|
| postcoderequired | string | UK postcode within Cheshire West and Chester (e.g. CH2 3HX, CW8 1AB). |
{
"type": "object",
"fields": {
"postcode": "the postcode searched",
"addresses": "array of address objects with uprn, display, flat, house, street, town, postcode"
},
"sample": {
"data": {
"postcode": "62704",
"addresses": [
{
"flat": "",
"town": "Springfield",
"uprn": "100010022946",
"house": "123",
"street": "Main St",
"display": "123 Main St, Springfield, IL 62704",
"postcode": "62704"
}
]
},
"status": "success"
}
}About the Gov API
Address Lookup
The search_addresses endpoint accepts a UK postcode within the Cheshire West and Chester boundary (for example, CH2 3HX or CW8 1AB) and returns a structured list of matching properties. Each address object includes a uprn (Unique Property Reference Number), a human-readable display string, and individual fields for flat, house, street, town, and postcode. The UPRN is the key needed to fetch bin schedule data.
Bin Collection Schedule
The get_bin_schedule endpoint takes a uprn and returns two top-level arrays. The services array describes each waste service assigned to that property — including the service name, type (e.g. recycling, domestic, food, garden), the collection round identifier, and the collection frequency. The collections array lists individual collection events with a collection_date, service_type, status, and round field, sorted chronologically to cover both historical records and future scheduled dates.
Coverage and Scope
Data is limited to properties within the Cheshire West and Chester council boundary. UPRNs outside that area will not return results. The schedule reflects the specific round and frequency assigned to each individual property, so results can differ between neighbouring addresses depending on which collection round serves them.
The Gov API is a managed, monitored endpoint for my.cheshirewestandchester.gov.uk — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when my.cheshirewestandchester.gov.uk changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official my.cheshirewestandchester.gov.uk API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a bin day reminder app that alerts residents by looking up their address via postcode and checking the next collection date.
- Automate weekly waste schedule emails for a housing estate by iterating over a list of UPRNs from
search_addressesresults. - Populate a property information page with waste service details using the
servicesarray fields (type, frequency, round). - Audit collection history for a property by filtering the
collectionsarray for past dates and their recorded status. - Verify that a new-build address has been assigned waste services before tenant move-in by checking the
servicesarray. - Display upcoming garden waste and recycling dates on a smart home dashboard using collection date and service type fields.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Cheshire West and Chester Council offer an official developer API for bin collection data?+
What does `get_bin_schedule` return beyond just the next collection date?+
services array (listing each assigned waste service with its type, round, and frequency) and a collections array containing every collection event available for the property — each with a collection_date, service_type, status, and round. This includes both past collections and future scheduled dates, not just the next upcoming one.Can I look up bin schedules for addresses outside Cheshire West and Chester?+
Does the API return the bin colour or container type for each service?+
services array includes the service name, type, round, and frequency, but does not include container colour or physical bin type. You can fork this API on Parse and revise it to add a mapping layer that associates service types with their standard bin colours.How granular is the address data returned by `search_addresses`?+
flat, house, street, town, and postcode alongside the uprn and a combined display string. This means you can distinguish between individual flats within the same building, each of which may have its own UPRN and potentially its own collection schedule.