{"uid":"cap_X57JqkIMZfe--roN46Aw4","slug":"energybilltoolkit-co-uk-a3c9a36a","name":"UK Council Waste Collection Date Lookup","description":"Resolve UK council waste collection dates from house number/name, postcode, and authority using safe address-to-UPRN mapping before calling council/HACS adapters.","url":"https://energybilltoolkit.co.uk/waste/api/tools/get-waste-collections","method":"POST","headers":{},"bodySchema":{"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."}}},"responseSchema":null,"example":{"request":{"postcode":"SW1A 1AA","houseNumber":"14"},"response":{"source":null,"status":"unsupported_authority","message":"Authority/source is not in the population-first MVP registry yet.","authority":null,"collections":[],"supported_sources":["birmingham_gov_uk","glasgow_gov_uk","sheffield_gov_uk","bristol_gov_uk","liverpool_gov_uk","manchester_uk","cardiff_gov_uk","newcastle_gov_uk","coventry_gov_uk","plymouth_gov_uk","bradford_gov_uk","southampton_gov_uk","fife_gov_uk","portsmouth_gov_uk","nottingham_city_gov_uk","derby_gov_uk","northherts_gov_uk","wakefield_gov_uk","eastlothian_gov_uk","doncaster_gov_uk","swansea_gov_uk","rotherham_gov_uk","lisburn_castlereagh_gov_uk","stockport_gov_uk","rushcliffe_gov_uk","york_gov_uk","charnwood_gov_uk","lewisham_gov_uk","jointwastesolutions_org","newcastle_staffs_gov_uk","norwich_gov_uk","bexley_gov_uk","fareham_gov_uk","haringey_gov_uk","wokingham_gov_uk","wandsworth_gov_uk","braintree_gov_uk","redbridge_gov_uk","tower_hamlets_gov_uk","lambeth_gov_uk","hackney_gov_uk","islington_gov_uk"]}},"exampleRequest":{"postcode":"SW1A 1AA","houseNumber":"14"},"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_6I9ei0-GAk-E1N-1r-_i9","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves upcoming waste collection dates for a UK address by mapping house number/postcode to UPRN and querying supported council adapters.","exampleAgentPrompt":"When is the next bin collection for 14 Church Road, postcode BS1 4RN? I need the collection dates and type — recycling, general waste, etc.","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:49:40.177Z","isFirstParty":false}