# My Cheshirewestandchester — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> 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.

**Category:** Government & Public Data | **Website:** [my.cheshirewestandchester.gov.uk/en/AchieveForms/?form_uri=sandbox-publish://AF-Process-0187a2f6-15cb-413a-8a3f-b6d14d63da57/AF-Stage-e18b38ff-be8a-45f4-ac14-f8821024f0c4/definition.json&redirectlink=%2Fen&cancelRedirectLink=%2Fen&consentMessage=yes](https://my.cheshirewestandchester.gov.uk/en/AchieveForms/?form_uri=sandbox-publish://AF-Process-0187a2f6-15cb-413a-8a3f-b6d14d63da57/AF-Stage-e18b38ff-be8a-45f4-ac14-f8821024f0c4/definition.json&redirectlink=%2Fen&cancelRedirectLink=%2Fen&consentMessage=yes) | **Docs:** [parse.bot/marketplace/3e8268e3-0761-4775-8bc9-81ac678b807e/my-cheshirewestandchester-gov-uk-api](https://parse.bot/marketplace/3e8268e3-0761-4775-8bc9-81ac678b807e/my-cheshirewestandchester-gov-uk-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/my-cheshirewestandchester/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get bin schedule

Get the bin collection schedule for a specific property identified by its UPRN. Returns the assigned waste services (recycling, domestic, food, garden) with their collection frequency, and a list of upcoming collection dates with their status. By default only collections on or after today are returned; supply from_date to override the cutoff.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `from_date` | string | No | ISO 8601 date (YYYY-MM-DD) cutoff. Only collections on or after this date are returned. Omitting defaults to today's date, returning only current and future collections. |
| `uprn` | string | Yes | Unique Property Reference Number from search_addresses results (e.g. 100010022946). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/my-cheshirewestandchester/get-bin-schedule \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"from_date":"<string>","uprn":"<string>"}'
```

### Search addresses

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.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `postcode` | string | Yes | UK postcode within Cheshire West and Chester (e.g. CH2 3HX, CW8 1AB). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/my-cheshirewestandchester/search-addresses \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"postcode":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.