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

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-bca-co-uk-api-9cce4908/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-bca-co-uk-api-9cce4908/get_locations \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-bca-co-uk-api-9cce4908/get_menu_links \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-bca-co-uk-api-9cce4908/get_news \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-bca-co-uk-api-9cce4908/get_sales_schedule \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-bca-co-uk-api-9cce4908/get_vehicle_types \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```