---
title: "Poll price watch events"
method: GET
path: "/v1/subscriptions/events"
tags: ["Subscriptions"]
---

# Poll price watch events

`GET /v1/subscriptions/events`

Poll-based feed of events triggered by your price watches. Pass the response `cursor`
back as `since` to fetch only newer events. Polling this operation does not consume the
account's monthly request quota and has its own rate-limit lane.

## Query parameters

- `since` integer
- `limit` integer
- `watch_id` string

## Response `200`

Events feed

- object
  - `status` string
  - `data` object
    - `cursor` integer
    - `has_more` boolean
    - `events` object[]

## Other responses

- `401` — Unauthorized
- `500` — Unexpected server error. Retry transient failures with bounded backoff and retain the request ID when contacting support.

---

[API](https://skmtc.net/oilpriceapi/apis/oil-price-api-v1.md) · [All operations](https://skmtc.net/oilpriceapi/apis/oil-price-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/oilpriceapi/oil-price-api-v1/revisions/5a5ce424cacc/schema)