> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nephia.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# Watches

> Subscribe to search criteria and receive webhook events on each poll tick.

A **Watch** polls a Source on a fixed interval, compares results to the previous snapshot, and emits webhook events when matches change. See [Webhooks](/webhooks) for payload shape, signatures, and event types.

## Lifecycle

| Action | Method                                  | Notes                                                             |
| ------ | --------------------------------------- | ----------------------------------------------------------------- |
| Create | `POST /v1/{source}/watches`             | Provide `criteria`, `refresh_interval_seconds`, and `webhook_url` |
| List   | `GET /v1/{source}/watches`              | All watches for your Account                                      |
| Get    | `GET /v1/{source}/watches/{id}`         | Single watch for your Account                                     |
| Pause  | `POST /v1/{source}/watches/{id}/pause`  | Stops polling; `pausedReason: user_paused`                        |
| Resume | `POST /v1/{source}/watches/{id}/resume` | Restarts polling after manual pause or insufficient credits       |
| Delete | `DELETE /v1/{source}/watches/{id}`      | Stops polling and removes the watch                               |

## Per-Source limits

| Source | Base path            | Interval min–max | Active cap |
| ------ | -------------------- | ---------------- | ---------- |
| Vinted | `/v1/vinted/watches` | 15s–3600s        | 50         |
| X      | `/v1/x/watches`      | 60s–3600s        | 20         |

## Billing

Each poll tick charges **4 credits** before the poll runs. See [Credits — Watch billing](/credits#watch-billing).

When credits are insufficient, the watch is auto-paused with `pausedReason: insufficient_credits`. Polling does not resume automatically — call `POST /v1/{source}/watches/{id}/resume` after topping up.

## Activity log

`GET /v1/{source}/watches/{id}/activity` returns operational events for a watch: `poll.completed`, `poll.failed`, `webhook.delivered`, `webhook.failed`. Each entry includes `creditsCharged`, `eventsEmitted`, and delivery metadata where applicable.

```bash theme={null}
curl "https://api.nephia.cc/v1/vinted/watches/WATCH_ID/activity?since=2026-07-01T00:00:00.000Z" \
  -H "x-api-key: YOUR_API_KEY"
```

## Event types

See [Webhooks — Event types](/webhooks#event-types) for the canonical list.