# 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-my-cheshirewestandchester-gov-uk-api-3e8268e3/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-my-cheshirewestandchester-gov-uk-api-3e8268e3/get_bin_schedule \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-my-cheshirewestandchester-gov-uk-api-3e8268e3/search_addresses \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"postcode":"<string>"}'
```