---
title: "Verify one known marketplace source (golf-offer.v1)."
method: GET
path: "/v1/offers/verified"
---

# Verify one known marketplace source (golf-offer.v1).

`GET /v1/offers/verified`

## Request

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

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

## Query parameters

- `source_kind` 'deal' | 'product', required
- `source_id` string, uuid, required
- `canonical_product_id` string, uuid, required
- `variant_id` union, required
  - string, uuid
  - 'null'

## Headers

- `Idempotency-Key` string

## Response `200`

OK

- union
  - object
    - `schema_version` 'golf-offer.v1', required
    - `status` 'verified_offer', required
    - `reason` string, nullable, required
    - `offer` AgentOffer, required: Read-only observed evidence. verified_offer is not purchase readiness. Currency is unknown; no click attribution or purchase authority is created. valid_until bounds verification evidence, not a merchant price guarantee.
      - `source` object, required
        - `kind` 'deal' | 'product', required
        - `id` string, uuid, required
      - `canonical_product_id` string, uuid, required
      - `offer_id` string, uuid, required
      - `variant_id` string, uuid, nullable, required
      - `variant` object, nullable, required
        - `hand` string, nullable, required
        - `flex` string, nullable, required
        - `loft` number, nullable, required
        - `shaftMaterial` string, nullable, required
        - `shaftModel` string, nullable, required
        - `setMakeup` string, nullable, required
        - `headSize` string, nullable, required
        - `length` string, nullable, required
        - `condition` string, nullable, required
      - `attributes` object, required
      - `title` string, required
      - `merchant` string, required
      - `image_url` string, nullable, required
      - `price` object, required
        - `amount` number, nullable, required
        - `currency` unknown, required
        - `observed_at` string, date-time, required
        - `freshness` string, required
      - `last_observed_price` object, required
        - `amount` number, required
        - `currency` unknown, required
        - `observed_at` string, date-time, required
      - `stock` object, required
        - `in_stock_at_observation` unknown, required
        - `observed_at` string, date-time, required
      - `verification` object, required
        - `path` 'chip-commerce-gate', required
        - `link_verified_at` string, date-time, required
        - `policy_version` string, required
        - `valid_until` string, date-time, required
      - `affiliate` object, required
        - `status` 'affiliate' | 'nonaffiliate', required
        - `network` string, required
        - `url` string, required
        - `click_attribution` 'not_created', required
      - `unknown_fields` string[], required
      - `actionability` object
        - `status` 'not_purchase_ready', required
        - `blockers` string[], required
  - object
    - `schema_version` 'golf-offer.v1', required
    - `status` 'check_price', required
    - `reason` string, nullable, required
    - `offer` AgentOffer, required: Read-only observed evidence. verified_offer is not purchase readiness. Currency is unknown; no click attribution or purchase authority is created. valid_until bounds verification evidence, not a merchant price guarantee.
      - `source` object, required
        - `kind` 'deal' | 'product', required
        - `id` string, uuid, required
      - `canonical_product_id` string, uuid, required
      - `offer_id` string, uuid, required
      - `variant_id` string, uuid, nullable, required
      - `variant` object, nullable, required
        - `hand` string, nullable, required
        - `flex` string, nullable, required
        - `loft` number, nullable, required
        - `shaftMaterial` string, nullable, required
        - `shaftModel` string, nullable, required
        - `setMakeup` string, nullable, required
        - `headSize` string, nullable, required
        - `length` string, nullable, required
        - `condition` string, nullable, required
      - `attributes` object, required
      - `title` string, required
      - `merchant` string, required
      - `image_url` string, nullable, required
      - `price` object, required
        - `amount` number, nullable, required
        - `currency` unknown, required
        - `observed_at` string, date-time, required
        - `freshness` string, required
      - `last_observed_price` object, required
        - `amount` number, required
        - `currency` unknown, required
        - `observed_at` string, date-time, required
      - `stock` object, required
        - `in_stock_at_observation` unknown, required
        - `observed_at` string, date-time, required
      - `verification` object, required
        - `path` 'chip-commerce-gate', required
        - `link_verified_at` string, date-time, required
        - `policy_version` string, required
        - `valid_until` string, date-time, required
      - `affiliate` object, required
        - `status` 'affiliate' | 'nonaffiliate', required
        - `network` string, required
        - `url` string, required
        - `click_attribution` 'not_created', required
      - `unknown_fields` string[], required
      - `actionability` object
        - `status` 'not_purchase_ready', required
        - `blockers` string[], required
  - object
    - `schema_version` 'golf-offer.v1', required
    - `status` 'unavailable', required
    - `reason` string, nullable, required
    - `offer` unknown, required

## Other responses

- `400`: Invalid input.
- `402`: Key required. Body carries pricing_url, free_key_url, docs_url and checkout_url when set.
- `409`: Idempotency key already used for this API key when atomic metering is enabled.
- `429`: Rate limit or quota reached. Body carries retry_after_seconds and the same URLs.
- `502`: Upstream data request failed.
- `503`: Backend or atomic usage reservation/finalization unavailable.

---

[API](https://skmtc.dev/golfdata/apis/golfdataapi.md) · [All operations](https://skmtc.dev/golfdata/apis/golfdataapi/llms.txt) · [OpenAPI document](https://skmtc.dev/golfdata/apis/golfdataapi/revisions/f65dc04ba24a?raw)