Skip to main content
GET
Retrieve Event
Credits: 1 per record.
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. Each event is returned in the payload_version it was stored with: a v1 event stays v1 after new events switch to v2. See Payload versions. 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 names: status, 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
office_action.issued at payload_version: 2 only: the prosecution-history row, exactly as Trademark Events returns it (hst_ id, raw {code, label}, nice_class, sequence_number). A v1 office_action.issued carries the flat event_date, event_code, event_label, scope, status_after_event, nice_class_number, description, source_identifier and sequence_no instead.
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.
object
trademark.corrected only: { kind }, why this status change corrects a status Signa published earlier. kind is status (Signa published a wrong status and this reverses it) or late_office_record (office records reached Signa late). The rest of the body is the trademark.status_changed shape. See trademark.corrected.

Code Examples