Skip to main content
GET
List Events
Beta. The event ledger and its replay rail are stable enough to build on, but the per-event data payloads are versioned by payload_version and their shape is not yet frozen. Pin payload_version in your consumer and read the changelog before upgrading.

Overview

Every webhook Signa sends you is also a row in your organization’s event ledger, addressable by the same evt_* id that arrives in the webhook-id header. The ledger is append-only and retained for 30 days. Two ways to read it:
  • Newest first (sort=-id, the default) with cursor — a browse/tail feed.
  • Oldest first (sort=id) with after — a durable replay from a checkpoint you persist. This is the recovery path when your receiver was down: store the last evt_* you processed, and ask for everything after it.
Requires the events:read scope.

Query Parameters

integer
default:"20"
Page size (1-100).
string
Opaque cursor from the previous response. Cannot be combined with after.
string
default:"-id"
-id (newest first) or id (oldest first). after requires id.
string
Exclusive evt_* replay checkpoint. Valid only with sort=id. Returns 410 replay_window_expired when the checkpoint has aged out of the 30-day window.
string
Filter by event type(s), comma-separated: alert.created, trademark.status_changed, office_action.issued.
string
Filter by office code(s), comma-separated. WIPO ST.3 uppercase (US, EM); legacy acronym slugs (uspto, euipo) and EU are also accepted.
string
Filter by trademark ID (tm_*).
string
ISO date or timestamp — events recorded by Signa at or after this time.
string
Filter by the portfolio membership snapshot taken when the event was recorded. Applies to every family, alert.created included: an alert is in the portfolio only when its matched mark was a member at event time. Later membership changes never rewrite history. Requires portfolios:manage.

Response

string
Always "list".
object[]
Array of event summaries.
boolean
Whether another page exists.
object
{ cursor } — opaque next-page cursor, null when exhausted.

Errors

Code Examples

  • Retrieve Event - full detail with field-level before/after diffs
  • List Alerts - the alert resource an alert.created event wraps
  • Webhooks - the push rail carrying the same evt_* ids