# Troostwijk Auctions — 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 auction lots on Troostwijk Auctions to find detailed information about items including specifications, current bidding status, images, and physical locations. Quickly access comprehensive lot details to help you make informed bidding decisions or discover items of interest.

**Category:** Marketplaces | **Website:** [www.troostwijkauctions.com/](https://www.troostwijkauctions.com/) | **Docs:** [parse.bot/marketplace/fd76ba0a-3c80-4e41-9051-1e55b37706f1/troostwijkauctions-com-api](https://parse.bot/marketplace/fd76ba0a-3c80-4e41-9051-1e55b37706f1/troostwijkauctions-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/troostwijk-auctions/`
**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 lot details

Retrieve full details for a specific auction lot including specifications (attributes), description, images, auction information, viewing days, and collection days. The slug is available from search_lots results. Returns a single Lot with all available metadata.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `language` | string | No | Language for lot details. Accepted values: 'en', 'nl', 'de', 'fr', 'it', 'es', 'pl', 'ro', 'sv', 'no', 'fi'. |
| `slug` | string | Yes | Lot URL slug from search_lots results[*].slug (e.g. '2025-excavator-vtw-10-mini-excavator-A1-40139-212'). |

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

### Get lots by display ids

Fetch combined live bidding data and detailed metadata for up to 20 lots by their display IDs in a single batched request. Returns current bid amounts, bid counts, bidding status, sale terms, end dates, plus full lot details including attributes, images, location, auction info, viewing and collection days. Lots not found are returned with an error marker. Accepts a comma-separated list of display IDs. Uses a single upstream GraphQL call regardless of batch size.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `display_ids` | string | Yes | Comma-separated Troostwijk display IDs (e.g. 'A1-47383-311,A1-44177-240'). Maximum 20 per request. |
| `language` | string | No | Language for lot details. Accepted values: 'en', 'nl', 'de', 'fr', 'it', 'es', 'pl', 'ro', 'sv', 'no', 'fi'. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/troostwijk-auctions/get-lots-by-display-ids \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"display_ids":"<string>","language":"<string>"}'
```

### Search lots

Full-text search across Troostwijk auction lots. query matches lot titles; results include bidding status, current bid, location, and images. Supports country filtering and sorting by end date. Paginates via page number. Each result exposes a slug for fetching full details via get_lot_details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country` | string | No | Two-letter country code to filter results (e.g. 'nl', 'be', 'de', 'fr', 'at'). Omitting returns results from all countries. |
| `language` | string | No | Language for search results. Accepted values: 'en', 'nl', 'de', 'fr', 'it', 'es', 'pl', 'ro', 'sv', 'no', 'fi'. |
| `page` | integer | No | Page number for pagination. |
| `page_size` | integer | No | Number of results per page. |
| `query` | string | Yes | Search term to find lots (e.g. 'excavator', 'tractor', 'forklift'). |
| `sort_by` | string | No | Field to sort results by. Accepted value: 'endDate'. Omitting sorts by relevance. |
| `sort_direction` | string | No | Sort direction. Used with sort_by. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/troostwijk-auctions/search-lots \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"country":"<string>","language":"<string>","page":"<integer>","page_size":"<integer>","query":"<string>","sort_by":"<string>","sort_direction":"<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.