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

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

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-manheim-co-uk-api-2f19b322/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.paywithlocus.com/api/wrapped/parse-manheim-co-uk-api-2f19b322/get_auction_centre_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-manheim-co-uk-api-2f19b322/get_auction_centres \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-manheim-co-uk-api-2f19b322/get_auction_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-manheim-co-uk-api-2f19b322/get_filter_options \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-manheim-co-uk-api-2f19b322/get_vehicle_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-manheim-co-uk-api-2f19b322/get_vehicle_makes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-manheim-co-uk-api-2f19b322/get_vehicle_models_by_make \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-manheim-co-uk-api-2f19b322/search_vehicles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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>"}'
```