Discover admitted marketplace sources and verify each through the Chip gate.

Costs 2 lookup(s) at $0.005 each. Requires x-api-key.

get/v1/offers/discover

Request

  • Base URL: https://golfdata.co
  • URL: https://golfdata.co/v1/offers/discover
  • Auth: API key in header x-api-key

Query parameters

canonical_product_idstring uuid required
string uuid
OR
'null'

Exact variant UUID or literal null. null means no selectable variant, never any variant. Discovery may return variant_required; selection metadata is not an offer.

offsetinteger

Headers

Idempotency-Keystring

8–128 characters. Reuse returns 409 without a second charge only when atomic metering is enabled. The legacy metering lane ignores this header; do not assume replay protection.

Response

OK

schema_version'golf-offers.v1' required
canonical_product_idstring uuid required
variant_idstring uuid nullable required
status'offers' | 'unavailable' | 'variant_required' | 'variant_unavailable' | 'invalid_request' required
variants_truncatedboolean required

Changes

No recorded changes to this operation across all 1 revision of this API.