{"uid":"cap_cSClvboWHy7OzmBiy8Te-","slug":"energy-bill-toolkit-cleanest-window-api-c4d47b8f","name":"Energy Bill Toolkit – Cleanest Window API","description":"Pay-per-use EBT screening endpoint","url":"https://energybilltoolkit.co.uk/decision-tools/api/carbon/cleanest-window","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"to":{"type":"string","format":"date-time"},"from":{"type":"string","format":"date-time"},"durationMinutes":{"type":"integer","maximum":720,"minimum":30,"multipleOf":30}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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_jTXKBflxkqGn455nkL992","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":"Identifies the cleanest (lowest-carbon) time window within a given date-time range for electricity consumption in the UK, based on grid carbon intensity data.","exampleAgentPrompt":"Find the cleanest 60-minute electricity window between 8am and 6pm today so I can schedule my EV charge for the lowest carbon impact.","exampleUseCases":[{"title":"EV charging carbon optimisation","prompt":"I want to charge my electric car sometime between 7am and 11pm tonight — can you find the cleanest 90-minute window in that period so I minimise my carbon footprint?"},{"title":"Smart appliance scheduling","prompt":"What's the greenest 30-minute slot to run my dishwasher between noon and 8pm today based on UK grid carbon intensity?"},{"title":"Home energy automation trigger","prompt":"Check the carbon intensity forecast between now and midnight and tell me the cleanest 2-hour window — I'll use it to decide when to run my heat pump."}],"resultDescription":"Returns the optimal (lowest carbon intensity) time window within the requested range, including the recommended start and end times and associated carbon metrics, given a duration between 30 and 720 minutes in 30-minute increments.","failureModes":["Invalid datetime format for 'from' or 'to' fields returns a 400 error","Duration not a multiple of 30 minutes returns a validation error","Duration outside the 30–720 minute range is rejected","Date range too narrow to fit the requested duration returns an error","Future forecasts beyond grid data availability may return no result or degraded data","Payment not included or insufficient triggers a 402 Payment Required response"],"whenToPreferThis":"Choose this endpoint when you need to find the optimal low-carbon time window for scheduling electricity-intensive tasks (EV charging, appliances, heat pumps) on the UK grid. It is specifically designed for carbon-aware scheduling rather than general energy pricing or tariff lookup, and works on a pay-per-use basis making it cost-effective for occasional or automated queries.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:48:35.089Z","isFirstParty":false}