GET /v1/products/watches/{watch_id} — get a watch

The GET /v1/products/watches/{watch_id} endpoint returns the full details of a single product watch. You can also retrieve watches by metadata without knowing the watch ID — see query by metadata below.

Endpoint

GET /v1/products/watches/{watch_id}

Path parameters

string

required

The unique identifier of the watch to retrieve. You can find this value in the watch_id field returned by list, create, or update responses.

Headers

string

required

Bearer token for authentication. Format: Bearer {your_api_key}.

Example request

curl --request GET \
  --url 'https://api.affiliate.com/v1/products/watches/a0b49c91-2eef-4aa1-9b30-4816147680f0' \
  --header 'Authorization: Bearer {your_api_key}'

Response

{
  "data": {
    "watch_id": "a0b49c91-2eef-4aa1-9b30-4816147680f0",
    "name": "Nike Shoe Price Drop Watch",
    "target_type": "product",
    "target_id": "8099987467386791069",
    "status": "active",
    "metadata": {
      "key1": "value1",
      "campaign": "summer_sale"
    },
    "rules": [
      {
        "field": "final_price",
        "start_value": 199.99,
        "condition": "decrease",
        "threshold": {
          "type": "percentage",
          "value": 50
        }
      }
    ],
    "notifications": [
      {
        "channel": "webhook",
        "channel_target": "https://example.com/webhooks/watch",
        "frequency": "immediately",
        "enabled": true
      }
    ],
    "filters": [
      {
        "field": "merchant.id",
        "operator": "=",
        "value": "41357"
      }
    ],
    "expire_timestamp": 1774751812,
    "created_at": "2025-12-29 02:36:53",
    "last_checked_at": null
  },
  "meta": {
    "trace_id": "019b74ed-15fe-72f5-a0c8-26727cbc0285"
  }
}

Response fields

`data` object

string

The unique identifier for this watch.

string

The human-readable name assigned at creation.

string

The watch type: "product", "asin", or "barcode".

string

The product identifier being watched.

string

Current watch status: "active", "paused", or "completed". A watch becomes "completed" when a rule condition is met.

object

Custom key-value pairs attached to the watch.

object[]

The conditions that trigger a notification.

Show Rule object

string

The product attribute being monitored.

number | null

The baseline value at the time the watch was created. null if no baseline was captured yet.

string

The comparison condition, such as "decrease", "equals", or "change".

object

The magnitude of change required. type is "value" or "percentage"; value is the numeric or string threshold.

object[]

The configured notification channels.

Show Notification object

string

The notification channel. Currently always "webhook".

string

The webhook URL.

string

Notification frequency. Currently always "immediately".

boolean

Whether the notification channel is active.

object[]

Filters limiting which product listings can trigger the watch. Each object has field, operator, and value properties.

integer

UNIX timestamp of when the watch expires.

string

ISO 8601 datetime when the watch was created.

string | null

ISO 8601 datetime of the most recent check. null if the watch has not been checked yet.

`meta` object

string

Unique identifier for this request. Include this value when contacting support.

Query by metadata

If you tagged your watches with metadata at creation, you can retrieve them without knowing the watch ID. Use the same GET /v1/products/watches endpoint with metadata[key]=value query parameters.

GET /v1/products/watches?metadata[campaign]=summer_sale

You can combine multiple metadata filters:

GET /v1/products/watches?metadata[campaign]=summer_sale&metadata[priority]=high

Example

curl --request GET \
  --url 'https://api.affiliate.com/v1/products/watches?metadata[campaign]=summer_sale' \
  --header 'Authorization: Bearer {your_api_key}'

The response uses the same paginated format as list watches.

Account

Networks

Merchants

Products

Tools

Watches

Product Lists

Pools

Reports

GET /v1/products/watches/{watch_id} — get a watch

Endpoint

Path parameters

Headers

Example request

Response

Response fields

`data` object

`meta` object

Query by metadata

Example

​Endpoint

​Path parameters

​Headers

​Example request

​Response

​Response fields

​data object

​meta object

​Query by metadata

​Example

Endpoint

Path parameters

Headers

Example request

Response

Response fields

`data` object

`meta` object

Query by metadata

Example