Skip to content

GET /v3/auction/{auctionId}/sponsors — sponsor wall

GET
/v3/auction/{auctionId}/sponsors
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).

auctionId
required
integer
Example
33934

The sponsor wall, in contract order.

Media type application/json
object
sponsors
required
Array<object>
<= 250 items
object
guid
required

Stable list key and the click-tracking key for [public]auction/sponsorclick?auctionSponsorGuid=. Always a string.

string
image
required

The raw stored logo URL (pipe it through the client’s default-image fallback); null when empty.

string
nullable
url
required

The sponsor’s link; null when empty.

string
nullable
truncated

Present (and true) only when the auction has more than 250 sponsors and the list was cut at 250.

boolean
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
}
]
}

validation_error — auctionId is 0.

Media type application/json

Unified error envelope. retryAfter is present only on transient (429 / 503) responses.

object
error
required

Stable machine-readable error code (e.g. unauthorized, forbidden, not_found, validation_error, unavailable).

string
message
required

Human-readable explanation.

string
retryAfter

Seconds to wait before retrying. Present on 429 and 503.

integer
Example generated
{
"error": "example",
"message": "example",
"retryAfter": 1
}

Private event — invitation code required (private_event_pin_required); exchange it at the access route.

Media type application/json

Unified error envelope. retryAfter is present only on transient (429 / 503) responses.

object
error
required

Stable machine-readable error code (e.g. unauthorized, forbidden, not_found, validation_error, unavailable).

string
message
required

Human-readable explanation.

string
retryAfter

Seconds to wait before retrying. Present on 429 and 503.

integer
Example generated
{
"error": "example",
"message": "example",
"retryAfter": 1
}

Not found (unknown or deleted id, or a privacy-blocked auction — a 403 would assert existence).

Media type application/json

Unified error envelope. retryAfter is present only on transient (429 / 503) responses.

object
error
required

Stable machine-readable error code (e.g. unauthorized, forbidden, not_found, validation_error, unavailable).

string
message
required

Human-readable explanation.

string
retryAfter

Seconds to wait before retrying. Present on 429 and 503.

integer
Example generated
{
"error": "example",
"message": "example",
"retryAfter": 1
}

Rate limited; Retry-After seconds.

Media type application/json

Unified error envelope. retryAfter is present only on transient (429 / 503) responses.

object
error
required

Stable machine-readable error code (e.g. unauthorized, forbidden, not_found, validation_error, unavailable).

string
message
required

Human-readable explanation.

string
retryAfter

Seconds to wait before retrying. Present on 429 and 503.

integer
Example generated
{
"error": "example",
"message": "example",
"retryAfter": 1
}