# Encheres Publiques — 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 real estate, vehicle, art, and equipment auctions across France, viewing detailed lot information and upcoming auction events from various organizers. Filter auction listings by category and type to find specific items and compare auction details to make informed bidding decisions.

**Category:** Marketplaces | **Website:** [encheres-publiques.com/](https://encheres-publiques.com/) | **Docs:** [parse.bot/marketplace/e370c383-8ea1-4b3e-b3ee-fe92cb66bc02/encheres-publiques-com-api](https://parse.bot/marketplace/e370c383-8ea1-4b3e-b3ee-fe92cb66bc02/encheres-publiques-com-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/encheres-publiques/`
**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 event detail

Retrieve full details of a single auction event by its numeric ID. Returns the event schedule, organizer, address, and a mosaique of its lots. Returns input_not_found when the event does not exist.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `event_id` | string | Yes | Unique numeric ID of the event. Obtainable from list_auction_events results collection[*].id. |

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

### Get auction lot detail

Retrieve full details of a single auction lot by its numeric ID. Returns pricing, description, address, event info, organizer, photos, and property-specific criteria. Returns input_not_found when the lot does not exist.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lot_id` | string | Yes | Unique numeric ID of the lot. Obtainable from search_auction_lots results collection[*].id. |

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

### List auction events

List upcoming and recent auction events sorted by opening date (furthest future first). Supports filtering by category and location. Paginates via the last item's ID as cursor.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category slug to filter events. |
| `cursor` | string | No | Pagination cursor (last item's id from a previous response) to fetch the next page. |
| `limit` | integer | No | Number of results to return per page. |
| `location` | string | No | Location slug to filter by geographic area (e.g. paris-75). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/encheres-publiques/list-auction-events \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","cursor":"<string>","limit":"<integer>","location":"<string>"}'
```

### List organizer profiles

List auction organizer profiles (tribunals, notaries, auction houses, bailiffs) sorted by trending popularity. Returns a single page of up to limit profiles.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of results to return. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/encheres-publiques/list-organizer-profiles \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>"}'
```

### Search auction lots

Full-text search over French public auction lots. Returns results sorted by trending popularity. Supports filtering by category, sub-category, location, and whether to include past/sold lots. Each lot includes pricing, status, event info, and organizer. Paginates via the last item's ID as cursor.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category slug to filter lots. |
| `cursor` | string | No | Pagination cursor (last item's id from a previous response) to fetch the next page. |
| `limit` | integer | No | Number of results to return per page. |
| `location` | string | No | Location slug to filter by geographic area (e.g. paris-75). |
| `sub_category` | string | No | Sub-category slug to narrow results within a category (e.g. appartements, maisons, terrains). |
| `termine` | boolean | No | Whether to include past/sold lots in results. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/encheres-publiques/search-auction-lots \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","cursor":"<string>","limit":"<integer>","location":"<string>","sub_category":"<string>","termine":"<boolean>"}'
```

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