Skip to main content
GET
/
v1
/
events
/
{id}
Get Event
curl --request GET \
  --url https://api.example.com/v1/events/{id}
{
  "id": 104829,
  "object": "event",
  "type": "trademark.status_changed",
  "trademark_id": "tm_8kLm2nPq",
  "office_code": "uspto",
  "version": 7,
  "changed_fields": ["status_primary", "status_stage"],
  "changes": {
    "status_primary": {
      "before": "pending",
      "after": "active"
    },
    "status_stage": {
      "before": "published",
      "after": "registered"
    }
  },
  "created_at": "2026-03-21T06:00:00Z",
  "livemode": true,
  "request_id": "req_pI5zA1bC"
}

​
Overview

Returns the full details of a specific trademark event, including the fields that changed and their before/after values. Use this to inspect individual events referenced in alert notifications, webhook payloads, or activity feeds.

​
Path Parameters

​
id
bigint
required
Event ID (numeric, e.g., 104829)

​
Response

​
id
bigint
Event ID (numeric, not prefixed)
​
object
string
Always "event"
​
type
string
Event type (e.g., trademark.updated, trademark.status_changed)
​
trademark_id
string
Associated trademark ID (tm_*)
​
office_code
string
Office code (e.g., uspto, euipo)
​
version
integer
Aggregate version number for this trademark at the time of the event
​
changed_fields
string[]
Array of field names that changed in this event
​
changes
object
Object with {before, after} per changed field
​
created_at
string
ISO timestamp when Signa ingested this event
{
  "id": 104829,
  "object": "event",
  "type": "trademark.status_changed",
  "trademark_id": "tm_8kLm2nPq",
  "office_code": "uspto",
  "version": 7,
  "changed_fields": ["status_primary", "status_stage"],
  "changes": {
    "status_primary": {
      "before": "pending",
      "after": "active"
    },
    "status_stage": {
      "before": "published",
      "after": "registered"
    }
  },
  "created_at": "2026-03-21T06:00:00Z",
  "livemode": true,
  "request_id": "req_pI5zA1bC"
}

​
Code Examples

curl https://api.signa.so/v1/events/104829 \
  -H "Authorization: Bearer sig_live_xxxxxxxxxxxx"

​
Errors

StatusTypeDescription
401unauthorizedMissing or invalid API key
404not_foundEvent ID does not exist
429rate_limitedToo many requests