Docs menu

Bonhams API endpoint

Bonhams Auction Detail API

Returns one Bonhams auction's facts by id: title, category, department, country, currency, sale dates, and lot count. Unlike the search endpoint, this is not restricted to upcoming/live auctions -- a historical/ended auction id resolves too.

GETapiKey1 credit/requestBonhamsbonhams.auctionDetailResponseDoc/bonhams/auctions/{id}

Endpoint facts

Method: GET
API path: /bonhams/auctions/{id}
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: Bonhams
Response schema: #/definitions/bonhams.auctionDetailResponseDoc

Bonhams API Try Bonhams Auction Detail API in Playground Bonhams API documentation

How this endpoint behaves

Path parameters:

id (required) — Bonhams auction id, e.g. 32001.

Response fields match the results[] entries of Bonhams Auction Search. Returns 404 when the auction id does not exist.

Live monitoring

Monitored request: GET /bonhams/auctions/32778
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.45 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /bonhams/auctions/32778
Items in departments: 1
Fields filled in every checked item: 2

Field	Filled in, of 1 checked	Values in the sample
code	1
name	1	“Native American”

Request parameters

Parameter	Type	Required	Default	Description	Example
id (path)	string	Yes		Bonhams auction id	32001
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/bonhams/auctions/32001" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "id": "32001",
    "title": "Home & Interiors: including the Linton Collection",
    "slug": "home-and-interiors-including-the-linton-collection",
    "url": "https://www.bonhams.com/auction/32001/home-and-interiors-including-the-linton-collection/",
    "brand": "bonhams",
    "auction_type": "ONLINE",
    "auction_status": "READY",
    "bidding_status": "IP",
    "categories": [
      {
        "code": "CAT-DEC",
        "name": "Decorative Arts & Furniture"
      }
    ],
    "departments": [
      {
        "code": "SIL",
        "name": "Silver"
      }
    ],
    "country": {
      "code": "AU",
      "name": "Australia"
    },
    "region": {
      "code": "ASIA_PACIFIC",
      "name": "Asia Pacific"
    },
    "currency": {
      "iso_code": "AUD",
      "bonhams_code": "AU$"
    },
    "end_date": {
      "datetime": "2026-09-03T04:00:00+00:00",
      "timestamp": 1788408000
    },
    "month": "September",
    "month_and_year": "September 2026",
    "year": "2026",
    "lot_count": 58,
    "image_url": "https://images3.bonhams.com/image?src=Images/live/2026-08/01/x.jpg",
    "is_auction_ended": false,
    "is_exhibition": false
  }
}

Request schema

No body schema

Response schema

#/definitions/bonhams.auctionDetailResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	bonhams.AuctionSummary	No
data.auction_status	string	No
data.auction_type	string	No
data.bidding_status	string	No
data.brand	string	No
data.categories	array	No
data.categories[].code	string	No
data.categories[].name	string	No
data.country	bonhams.NamedCode	No
data.country.code	string	No
data.country.name	string	No
data.currency	bonhams.Currency	No
data.currency.bonhams_code	string	No
data.currency.iso_code	string	No
data.currency.symbol	string	No
data.departments	array	No
data.departments[].code	string	No
data.departments[].name	string	No
data.end_date	bonhams.DateInfo	No
data.end_date.datetime	string	No
data.end_date.timestamp	integer	No
data.end_date.timezone	string	No
data.hammer_time	bonhams.DateInfo	No
data.hammer_time.datetime	string	No
data.hammer_time.timestamp	integer	No
data.hammer_time.timezone	string	No
data.id	string	No
data.image_url	string	No
data.is_auction_ended	boolean	No
data.is_exhibition	boolean	No
data.lot_count	integer	No
data.month	string	No
data.month_and_year	string	No
data.region	bonhams.NamedCode	No
data.region.code	string	No
data.region.name	string	No
data.slug	string	No
data.start_date	bonhams.DateInfo	No
data.start_date.datetime	string	No
data.start_date.timestamp	integer	No
data.start_date.timezone	string	No
data.title	string	No
data.url	string	No
data.year	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
500	Internal Server Error	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/bonhams/auctions/32001" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More Bonhams endpoint docs Bonhams API Bonhams Auction Lot Listing API documentation Bonhams Auction Search API documentation Bonhams Lot Detail API documentation Bonhams Lot Search API documentation

Open in Playground Back to group

Docs menu

Bonhams API endpoint

Bonhams Auction Detail API

GETapiKey1 credit/requestBonhamsbonhams.auctionDetailResponseDoc/bonhams/auctions/{id}

Endpoint facts

Method: GET
API path: /bonhams/auctions/{id}
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: Bonhams
Response schema: #/definitions/bonhams.auctionDetailResponseDoc

Bonhams API Try Bonhams Auction Detail API in Playground Bonhams API documentation

How this endpoint behaves

Path parameters:

id (required) — Bonhams auction id, e.g. 32001.

Response fields match the results[] entries of Bonhams Auction Search. Returns 404 when the auction id does not exist.

Live monitoring

Monitored request: GET /bonhams/auctions/32778
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.45 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /bonhams/auctions/32778
Items in departments: 1
Fields filled in every checked item: 2

Field	Filled in, of 1 checked	Values in the sample
code	1
name	1	“Native American”

Request parameters

Parameter	Type	Required	Default	Description	Example
id (path)	string	Yes		Bonhams auction id	32001
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/bonhams/auctions/32001" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "id": "32001",
    "title": "Home & Interiors: including the Linton Collection",
    "slug": "home-and-interiors-including-the-linton-collection",
    "url": "https://www.bonhams.com/auction/32001/home-and-interiors-including-the-linton-collection/",
    "brand": "bonhams",
    "auction_type": "ONLINE",
    "auction_status": "READY",
    "bidding_status": "IP",
    "categories": [
      {
        "code": "CAT-DEC",
        "name": "Decorative Arts & Furniture"
      }
    ],
    "departments": [
      {
        "code": "SIL",
        "name": "Silver"
      }
    ],
    "country": {
      "code": "AU",
      "name": "Australia"
    },
    "region": {
      "code": "ASIA_PACIFIC",
      "name": "Asia Pacific"
    },
    "currency": {
      "iso_code": "AUD",
      "bonhams_code": "AU$"
    },
    "end_date": {
      "datetime": "2026-09-03T04:00:00+00:00",
      "timestamp": 1788408000
    },
    "month": "September",
    "month_and_year": "September 2026",
    "year": "2026",
    "lot_count": 58,
    "image_url": "https://images3.bonhams.com/image?src=Images/live/2026-08/01/x.jpg",
    "is_auction_ended": false,
    "is_exhibition": false
  }
}

Request schema

No body schema

Response schema

#/definitions/bonhams.auctionDetailResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	bonhams.AuctionSummary	No
data.auction_status	string	No
data.auction_type	string	No
data.bidding_status	string	No
data.brand	string	No
data.categories	array	No
data.categories[].code	string	No
data.categories[].name	string	No
data.country	bonhams.NamedCode	No
data.country.code	string	No
data.country.name	string	No
data.currency	bonhams.Currency	No
data.currency.bonhams_code	string	No
data.currency.iso_code	string	No
data.currency.symbol	string	No
data.departments	array	No
data.departments[].code	string	No
data.departments[].name	string	No
data.end_date	bonhams.DateInfo	No
data.end_date.datetime	string	No
data.end_date.timestamp	integer	No
data.end_date.timezone	string	No
data.hammer_time	bonhams.DateInfo	No
data.hammer_time.datetime	string	No
data.hammer_time.timestamp	integer	No
data.hammer_time.timezone	string	No
data.id	string	No
data.image_url	string	No
data.is_auction_ended	boolean	No
data.is_exhibition	boolean	No
data.lot_count	integer	No
data.month	string	No
data.month_and_year	string	No
data.region	bonhams.NamedCode	No
data.region.code	string	No
data.region.name	string	No
data.slug	string	No
data.start_date	bonhams.DateInfo	No
data.start_date.datetime	string	No
data.start_date.timestamp	integer	No
data.start_date.timezone	string	No
data.title	string	No
data.url	string	No
data.year	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
500	Internal Server Error	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/bonhams/auctions/32001" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More Bonhams endpoint docs Bonhams API Bonhams Auction Lot Listing API documentation Bonhams Auction Search API documentation Bonhams Lot Detail API documentation Bonhams Lot Search API documentation

Open in Playground Back to group

Bonhams Auction Detail API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

Bonhams Auction Detail API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related