Skip to main content
GET
Retrieve Event
Beta. The data payload is versioned by payload_version and its shape is not yet frozen. See List Events.

Overview

Returns the full body for one ledger row — the same body the matching webhook delivery carried, so you can verify or re-read a delivery you already received. Trademark-family events include field-level diffs; alert.created renders its stored versioned payload. Requires the events:read scope.

Path Parameters

string
required
Event ID (evt_*). A raw numeric ID returns 400 validation_error; a valid public ID of another type returns 400 id_type_mismatch.

Response

Beyond the summary fields on List Events, the detail body carries:
integer
The aggregate version this event was recorded at.
string[]
The fields that changed, in public trademark field namesstatus, mark_text, publication_date, ir_number, or a changed child collection (owners, classifications). Fields Signa does not publish are omitted rather than renamed.
object
{ [field]: { before, after } }, keyed by the same public names as changed_fields.
string | null
The office-reported data date this event is from (YYYY-MM-DD), or null when the feed reports none. Day precision, and the meaning varies by office: USPTO transaction date, WIPO gazette date, snapshot offices the crawl date. Distinct from occurred_at, which is when Signa produced the event.
object[]
The portfolios the mark belonged to when the event was recorded, each { id, external_ref }, frozen at record time. Empty when the mark was in no portfolio. Absent on alert.created.

Errors

Code Examples