# BCA — 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.

> Browse BCA auction news, find remarketing centre locations, view available vehicle types, check upcoming sales schedules, and navigate the site menu. This public API lets you access essential auction information and logistics without requiring authentication.

**Category:** Automotive | **Website:** [bca.co.uk/](https://bca.co.uk/) | **Docs:** [parse.bot/marketplace/9cce4908-b50a-466c-b15c-5de529bf65d7/bca-co-uk-api](https://parse.bot/marketplace/9cce4908-b50a-466c-b15c-5de529bf65d7/bca-co-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/bca/`
**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 locations

Retrieve all BCA remarketing centre locations across the UK. Returns every location with contact details (phone, email), full address, GPS coordinates, weekday opening/closing times, and boolean flags for vehicle types handled (car, lcv, motorbike, leisure). No pagination — the full list is returned in one call.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/bca/get-locations \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get menu links

Retrieve navigation menu links for the BCA site. Returns a nested tree of menu items, each with label, link URL, visibility flag, and child items. Different menus serve different parts of the site (main nav, footer, social links, user account menu).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `menu_name` | string | No | Menu name to retrieve. Accepted values: Main-Menu, MyBCA-Menu, Footer, Footer-Legal, Footer-Info, Social-Links. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/bca/get-menu-links \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"menu_name":"<string>"}'
```

### Get news

Retrieve latest BCA news and industry insights articles. Returns paginated results ordered by published date descending. Each article includes title, published date, short description, full HTML content, image metadata, and tags. Pagination via offset/limit; total count is returned for client-side page calculation.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Max results to return per page. |
| `offset` | integer | No | Offset for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/bca/get-news \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","offset":"<integer>"}'
```

### Get sales schedule

Retrieve upcoming auction sales schedule across all BCA locations. Each result is a sale event with name, channel (e.g. InternetAuction), datetime, lot count, and closed-sale flag. Paginated via offset/limit; total count returned for client-side page calculation.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Max results to return per page. |
| `offset` | integer | No | Offset for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/bca/get-sales-schedule \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","offset":"<integer>"}'
```

### Get vehicle types

Get counts for different vehicle types available across all current auctions. Returns an array of facet objects, each with a vehicle type description and its current inventory count. The wildcard entry (*) represents the total across all types.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/bca/get-vehicle-types \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

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