# UK Council Waste Collection Date Lookup

> UK Council Waste Collection Date Lookup is a paid API for AI agents from energybilltoolkit.co.uk, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Resolves upcoming waste collection dates for a UK address by mapping house number/postcode to UPRN and querying supported council adapters.

## Facts

- Endpoint: POST https://energybilltoolkit.co.uk/waste/api/tools/get-waste-collections
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/energybilltoolkit-co-uk-a3c9a36a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_X57JqkIMZfe--roN46Aw4

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability energybilltoolkit-co-uk-a3c9a36a -d '<json body>'
```

Example prompt: When is the next bin collection for 14 Church Road, postcode BS1 4RN? I need the collection dates and type — recycling, general waste, etc.

## When to prefer this

Use this endpoint when you need real waste collection dates for a specific UK residential address and have the house number/name and postcode. It handles the UPRN address resolution step automatically before hitting council adapters, making it more reliable than calling council APIs directly. Best suited for UK-only use cases where the target council is in the supported list (Birmingham, Glasgow, Sheffield, Bristol, Liverpool, Cardiff, Coventry, Bradford, Fife, Nottingham, North Herts, East Lothian, Swansea, Lisburn Castlereagh, Rushcliffe).

## Known failure modes

- unsupported_authority: The council for the given postcode is not in the supported registry — returns empty collections and lists supported sources
- Address not found: UPRN mapping fails for the given house number and postcode
- Invalid postcode: Malformed or non-existent UK postcode causes a 400-level error
- No collections scheduled: Address resolves but no upcoming collections are found in council data
- Council data unavailable: Upstream council or HACS adapter is temporarily unreachable

## How this service works

Resolve UK council waste collection dates from house number/name, postcode, and authority using safe address-to-UPRN mapping before calling council/HACS adapters.

## Output

Returns the collection schedule for the matched address including collection dates, waste types, the council authority identified, and the data source used. If the authority is not yet supported, returns a list of currently supported councils and an 'unsupported_authority' status.

## Example request

```json
{
 "postcode": "SW1A 1AA",
 "houseNumber": "14"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "uprn": {
   "type": "string",
   "description": "Optional explicit UPRN; bypasses address resolution."
  },
  "street": {
   "type": "string",
   "description": "Optional street hint for ambiguous matches."
  },
  "postcode": {
   "type": "string",
   "description": "UK postcode for the property."
  },
  "authority": {
   "type": "string",
   "description": "HACS source module name or supported authority name."
  },
  "house_number_or_name": {
   "type": "string",
   "description": "House number or property name used for safe address-to-UPRN resolution."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/energybilltoolkit-co-uk-a3c9a36a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from energybilltoolkit.co.uk](https://www.zero.xyz/host/energybilltoolkit.co.uk/llms.txt)
