Gov APImy.cheshirewestandchester.gov.uk ↗
Check your household bin collection schedule by searching for your address in the Cheshire West and Chester council area. Find out when your bins are collected and plan your waste management accordingly.
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.my_cheshirewestandchester_gov_uk_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)
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": "CH2 3HX",
"addresses": [
{
"flat": "",
"town": "Chester",
"uprn": "100010022946",
"house": "11",
"street": "Panton Road",
"display": "11 Panton Road, Chester",
"postcode": "CH2 3HX"
}
]
},
"status": "success"
}
}About the Gov API
The Gov API on Parse exposes 2 endpoints for the publicly available data on my.cheshirewestandchester.gov.uk. Calls return JSON over HTTPS and are billed per successful response.
Pin a release with the API-Snapshot-Version header so canonical updates don't silently change your contract.