Find

GET

/preorders/offer_lookup

curl --request GET \
  --url 'https://app.stoqapp.com/api/v2/external/preorders/offer_lookup?id=string&name=Summer%20Sneaker%20Drop' \
  --header 'X-Auth-Token: <X-Auth-Token>'

• Production

Resolve one preorder offer from an exact id or a fuzzy name match. Returns the full offer (same shape as GET /preorders/offers/:id) on a unique match. If name matches more than one offer, returns {ambiguous: true, candidates: […]} instead of guessing – re-call with the chosen id. Omit both id and name for the most recently created offer.

Authorizations

• ApiKeyAuth

Parameters

Query Parameters

id

Example

string

name

Example

Summer Sneaker Drop

Responses

200

Success — the requested resource.

Media typeapplication/json

object

Example ^generated

{}

401

Missing or invalid X-Auth-Token.

Media typeapplication/json

Error envelope returned by every failed request.

object

errors

required

Array<string>

Example

{
  "errors": [
    "Unauthorized"
  ]
}

422

The request failed validation.

Media typeapplication/json

Error envelope returned by every failed request.

object

errors

required

Array<string>

Example

{
  "errors": [
    "name is required"
  ]
}

429

Rate limited — cost-weighted per token (read 1, write 2; 360 points / 60s). Check Retry-After.

Media typeapplication/json

Error envelope returned by every failed request.

object

errors

required

Array<string>

Example

{
  "errors": [
    "Rate limit exceeded"
  ]
}