---
title: "What happened, as a feed you can poll"
method: GET
path: "/v1/events"
tags: ["patent status"]
---

# What happened, as a feed you can poll

`GET /v1/events`

## Request

- Base URL: `https://api.patentdata.ai`
- URL: `https://api.patentdata.ai/v1/events`
- Auth: one of:
  - API key in header `X-API-KEY`
  - HTTP bearer

Answers: what happened to these applications / patents / entities since I last looked — office actions, allowances, abandonments, grants, publications, assignments, PTAB petitions, maintenance events — as detected by our nightly ingest. Filter by `types` and/or targets (at least one filter is required); page with `cursor`; use `since` (ISO date or datetime, on detected_at) for 'since my last poll'. The webhook alternative is POST /v1/monitors. Costs 1 request per 100 rows.

## Query parameters

- `types` string, nullable: Comma-separated event types, e.g. office_action,allowance,grant.
- `application_numbers` string, nullable: Comma-separated application numbers (no thousands separators: 17123456).
- `patent_numbers` string, nullable: Comma-separated patent numbers (no thousands separators: 11987654).
- `entity_ids` string, nullable: Comma-separated entity or family ids from /v1/entities/search.
- `since` string, date-time, nullable: Only events detected on/after this ISO date or datetime.
- `limit` integer: Page size. Each 100 rows returned costs 1 request unit.
- `cursor` string, nullable: Opaque cursor from a previous response's next_cursor. Omit for the first page.

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/patentdata/apis/patent-status-api.md) · [All operations](https://skmtc.dev/patentdata/apis/patent-status-api/llms.txt) · [OpenAPI document](https://skmtc.dev/patentdata/apis/patent-status-api/revisions/320133a82b42?raw)