# Manheim — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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.

> Search and browse vehicle auction listings from Manheim UK, filter by various criteria, and explore upcoming auction events and centre locations. Get detailed information about specific vehicles, auction centres, vehicle makes and models to help you find the right auction opportunity.

**Category:** Automotive | **Website:** [manheim.co.uk/](https://manheim.co.uk/) | **Docs:** [parse.bot/marketplace/2f19b322-6986-4a38-9608-501d6db4260b/manheim-co-uk-api](https://parse.bot/marketplace/2f19b322-6986-4a38-9608-501d6db4260b/manheim-co-uk-api)

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

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/manheim/`
**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 auction centre detail

Get details for a specific auction centre including name, address, phone number, and upcoming auctions in the next 7 days. Each upcoming auction includes date, name, and vehicle count info.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Auction centre slug from get_auction_centres (e.g. 'birmingham', 'leeds', 'bristol'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/manheim/get-auction-centre-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### Get auction centres

Retrieve the list of Manheim auction centres across the UK. Each centre includes a name, slug (for use with get_auction_centre_detail), and full URL.

**Estimated cost:** Metered

_No parameters required._

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

### Get auction events

Retrieve upcoming auction events within a date range. Returns events grouped by date with details on auction centre, vehicle counts, and vendors. Defaults to events in the next 30 days when no dates are specified.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `end_date` | string | No | End date in format 'dd/mm/yyyy HH:MM:SS' (e.g. '15/05/2026 00:00:00'). Defaults to 30 days from today. |
| `start_date` | string | No | Start date in format 'dd/mm/yyyy HH:MM:SS' (e.g. '01/05/2026 00:00:00'). Defaults to today. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/manheim/get-auction-events \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"end_date":"<string>","start_date":"<string>"}'
```

### Get filter options

Retrieve available search filter options with counts for each facet. Returns facets for VehicleType, Make, Model, FuelType, and SalesChannel. Each facet entry includes a Value (wire code), Text (display name), and Count (number of vehicles matching).

**Estimated cost:** Metered

_No parameters required._

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

### Get vehicle detail

Retrieve high-resolution images for a specific vehicle. Returns an array of image URLs. Vehicles without professional photography will return an empty images array.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `vehicle_id` | string | Yes | Vehicle ID from search_vehicles results (e.g. '1003581'). |

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

### Get vehicle makes

Retrieve list of all vehicle makes with current stock counts. Each entry includes Value (make identifier for filtering), Text (display name), and Count (number of vehicles currently listed).

**Estimated cost:** Metered

_No parameters required._

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

### Get vehicle models by make

Retrieve models for a specific vehicle make with current stock counts. Each model entry includes Value (make|model identifier for filtering), Text (model display name), Group (make name), and Count (number of vehicles).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `make` | string | Yes | Vehicle make (e.g. 'BMW', 'FORD'). Values from get_vehicle_makes. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/manheim/get-vehicle-models-by-make \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"make":"<string>"}'
```

### Search vehicles

Search for vehicle auction listings with optional filters. Returns paginated results with up to 30 vehicles per page. Pagination advances via the page parameter. Each vehicle includes make, model, grade, registration date, transmission, engine size, odometer reading, auction centre, and sales channels.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `auction_centre` | string | No | Filter by auction centre name (e.g. 'Colchester', 'Birmingham'). Values from get_auction_centres. |
| `fuel_type` | string | No | Filter by fuel type. Accepted values: 'Petrol', 'Diesel', 'Electric', 'Hybrid', 'BiFuel', 'Diesel PHEV', 'Petrol PHEV'. |
| `keyword` | string | No | Free-text search keyword. |
| `make` | string | No | Filter by vehicle make (e.g. 'BMW', 'FORD', 'AUDI'). Values from get_vehicle_makes. |
| `model` | string | No | Filter by vehicle model (e.g. 'BMW\|1 SERIES'). Values from get_vehicle_models_by_make. |
| `page` | integer | No | Page number for pagination. |
| `sales_channel` | string | No | Filter by sales channel. Accepted values: 'Physical Auction', 'Dealer Auction', 'Preview Stock'. |
| `vehicle_type` | string | No | Filter by vehicle type. Accepted values: 'Car', 'Van', 'Motorbike', 'Plant', 'Truck'. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/manheim/search-vehicles \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"auction_centre":"<string>","fuel_type":"<string>","keyword":"<string>","make":"<string>","model":"<string>","page":"<integer>","sales_channel":"<string>","vehicle_type":"<string>"}'
```

## Next steps

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