Endpoint Playground
Returns the lot listing for one Bonhams auction, optionally filtered by department and/or a free-text query.
14 Oct 2026: 20 results; 24 fields had a value in every checked item.
Sample value profiles: lot_number: 501 to 520, median 510; title: “An Attu polychrome lidded basket” and 16 other values; image_url: images2.bonhams.com.
curl 'https://api.crawlora.net/api/v1/bonhams/auctions/32001/lots' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| id (path) | string | Yes | 32001 | Bonhams auction id |
| q | string | No | Free-text search across lot title, catalog description, and footnotes | |
| department | string | No | Comma-separated department names (not a fixed enum -- varies per auction) | |
| page | integer | No | 1-based page number, default 1 | |
| per_page | integer | No | Results per page, default 48, max 100 |
{
"code": 200,
"msg": "OK",
"data": {
"auction_id": "32001",
"page": 1,
"per_page": 48,
"total": 1,
"total_pages": 1,
"results": [
{
"id": "32001-2",
"auction_id": "32001",
"lot_number": "2",
"title": "A pair of Scandanavian silver three-branch candelabra",
"status": "NEW",
"department": {
"code": "ORI-CHI",
"name": "Chinese Ceramics & Works of Art"
},
"country": {
"code": "AU",
"name": "Australia"
},
"currency": {
"iso_code": "AUD",
"bonhams_code": "AU$",
"symbol": "AU$"
},
"estimate_low": 800,
"estimate_high": 1200,
"starting_bid_amount": 800,
"sale_date": {
"datetime": "2026-09-03T04:01:00+00:00",
"timestamp": 1788408060,
"timezone": "Australia/Sydney"
},
"auction_type": "ONLINE",
"auction_status": "READY",
"auction_bidding_status": "IP",
"slug": "a-pair-of-scandanavian-silver-three-branch-candelabra",
"url": "https://www.bonhams.com/auction/32001/lot/2/a-pair-of-scandanavian-silver-three-branch-candelabra/",
"without_reserve": false,
"condition_report_available": false
}
]
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.