GET /v3/auction/{auctionId}/sponsors — sponsor wall
const url = 'https://api-ha-prod-p8.handbid.dev/v3/auction/33934/sponsors';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://api-ha-prod-p8.handbid.dev/v3/auction/33934/sponsors \ --header 'Authorization: Bearer <token>'The auction’s sponsor wall, the logos shown under “Thank You to Our Sponsors” (HAN-2910): auction_sponsor rows of type sponsor, not soft-deleted. The title / presenting sponsor is on the auction detail as titleSponsor; ticket sponsors and Sponsor Pages are /v3/sponsor/*. Bare v3 body (no envelope). Order is the contract: sortOrder ascending, ties by row id (sortOrder itself is not on the wire). No sponsors → {"sponsors": []}.
Capped at 250, not paginated. With more than 250 sponsors the body is the first 250 in contract order plus "truncated": true; the key is absent otherwise, so a client that sees it knows the wall is incomplete.
Identity-free, cached ~30 s per auction and invalidated by every manager sponsor edit. Gated like /goals: a caller who may not see the auction gets the same gate error.
Auth: optional (the token only feeds the gate and the auctionSponsors limiter).
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”Example
33934Responses
Section titled “ Responses ”The sponsor wall, in contract order.
object
object
Stable list key and the click-tracking key for [public]auction/sponsorclick?auctionSponsorGuid=. Always a string.
The raw stored logo URL (pipe it through the client’s default-image fallback); null when empty.
The sponsor’s link; null when empty.
Present (and true) only when the auction has more than 250 sponsors and the list was cut at 250.
Examples
Two sponsors
{ "sponsors": [ { "guid": "5f2a0c1e9b7d4a33", "image": "https://ucarecdn.com/0b9e4f2a-0000-4000-8000-000000000001/", "url": "https://sponsor-one.example" }, { "guid": "6a3b1d2f0c8e5b44", "image": null, "url": null } ]}More than 250 sponsors (elements abbreviated)
{ "sponsors": [ { "guid": "5f2a0c1e9b7d4a33", "image": "https://ucarecdn.com/0b9e4f2a-0000-4000-8000-000000000001/", "url": "https://sponsor-one.example" } ], "truncated": true}validation_error — auctionId is 0.
Unified error envelope. retryAfter is present only on transient (429 / 503) responses.
object
Stable machine-readable error code (e.g. unauthorized, forbidden, not_found, validation_error, unavailable).
Human-readable explanation.
Seconds to wait before retrying. Present on 429 and 503.
Example generated
{ "error": "example", "message": "example", "retryAfter": 1}Private event — invitation code required (private_event_pin_required); exchange it at the access route.
Unified error envelope. retryAfter is present only on transient (429 / 503) responses.
object
Stable machine-readable error code (e.g. unauthorized, forbidden, not_found, validation_error, unavailable).
Human-readable explanation.
Seconds to wait before retrying. Present on 429 and 503.
Example generated
{ "error": "example", "message": "example", "retryAfter": 1}Not found (unknown or deleted id, or a privacy-blocked auction — a 403 would assert existence).
Unified error envelope. retryAfter is present only on transient (429 / 503) responses.
object
Stable machine-readable error code (e.g. unauthorized, forbidden, not_found, validation_error, unavailable).
Human-readable explanation.
Seconds to wait before retrying. Present on 429 and 503.
Example generated
{ "error": "example", "message": "example", "retryAfter": 1}Rate limited; Retry-After seconds.
Unified error envelope. retryAfter is present only on transient (429 / 503) responses.
object
Stable machine-readable error code (e.g. unauthorized, forbidden, not_found, validation_error, unavailable).
Human-readable explanation.
Seconds to wait before retrying. Present on 429 and 503.
Example generated
{ "error": "example", "message": "example", "retryAfter": 1}