{"uid":"cap_IjoOvwlwT8vGkUXR5iS24","slug":"energybilltoolkit-co-uk-f8b16c83","name":"EnergyBillToolkit Postcode Schedule Options","description":"Return postcode-level schedule-option distributions and ambiguity percentages for council-native address candidates. This is a triage endpoint, not address proof and not an exact property lookup.","url":"https://energybilltoolkit.co.uk/waste/api/tools/get-postcode-schedule-options","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"postcode":{"type":"string","description":"UK postcode for postcode-level schedule-option triage."},"authority":{"type":"string","description":"HACS source module name or supported authority name."},"house_number_or_name":{"type":"string","description":"Optional house number/name used only to highlight which schedule option matches the requested property token."}}},"responseSchema":null,"example":{"request":{"postcode":"M1 1AA"},"response":{"source":null,"status":"unsupported_authority","message":"Authority/source is not in the population-first MVP registry yet.","authority":null,"schedule_options":[],"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","barnet_gov_uk","biffaleicester_co_uk","camden_gov_uk","ealing_gov_uk","enfield_gov_uk","harrow_gov_uk","havering_gov_uk","hounslow_gov_uk","nwleics_gov_uk","southwark_gov_uk","walthamforest_gov_uk"]}},"exampleRequest":{"postcode":"M1 1AA"},"tags":["x402"],"displayCostAmount":"0.01","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.01/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_gdl7IM7XkZvQE6pAfTBlI","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":"Returns postcode-level waste collection schedule-option distributions and ambiguity percentages for council address candidates in the UK.","exampleAgentPrompt":"What waste collection schedule options exist for postcode SW1A 1AA — show me the distribution of schedules and how ambiguous they are across the address candidates in that postcode?","exampleUseCases":null,"resultDescription":"A JSON payload containing the distribution of possible waste collection schedule options across council-native address candidates for the given postcode, along with ambiguity percentages indicating how much uncertainty exists about which schedule applies to any given address. This is a triage-level result, not an exact property match.","failureModes":["Invalid or malformed UK postcode returns an error or empty result","Postcode not found in council data returns no schedule options","Council data unavailability may return incomplete distributions","Very new or recently changed postcodes may have stale schedule data","Ambiguity of 100% means no schedule can be determined at postcode level alone"],"whenToPreferThis":"Use this endpoint when you need a fast, low-cost triage of possible waste collection schedules at the postcode level before committing to a full property-level lookup. Ideal when you have a postcode but not a specific house number, or when you want to understand how ambiguous schedule data is for a given area before doing exact resolution.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:44:36.653Z","isFirstParty":false}