Skip to main content
GET
/
v1
/
events
List Events
curl --request GET \
  --url https://api.example.com/v1/events
{
  "object": "list",
  "data": [
    {
      "id": 104829,
      "object": "event",
      "type": "trademark.status_changed",
      "trademark_id": "tm_8kLm2nPq",
      "office_code": "uspto",
      "created_at": "2026-03-21T06:00:00Z"
    },
    {
      "id": 104715,
      "object": "event",
      "type": "trademark.updated",
      "trademark_id": "tm_Xp4wQ7vR",
      "office_code": "euipo",
      "created_at": "2026-03-19T06:00:00Z"
    },
    {
      "id": 104602,
      "object": "event",
      "type": "trademark.created",
      "trademark_id": "tm_Ws8pL2mN",
      "office_code": "ukipo",
      "created_at": "2026-03-16T06:00:00Z"
    }
  ],
  "has_more": true,
  "pagination": {
    "cursor": "eyJpZCI6ImFiYyJ9"
  },
  "livemode": true,
  "request_id": "req_oH4yZ0aB"
}

​
Overview

Returns a paginated feed of trademark events across your monitored universe. Events represent changes detected during ingestion, such as status transitions, field updates, and corrections. This is ideal for building activity feeds, audit logs, and change-detection pipelines. Results are sorted by event ID descending (most recent first) by default.

​
Query Parameters

​
limit
integer
default:"20"
Items per page (max 100)
​
cursor
string
Pagination cursor from previous response
​
trademark_id
string
Filter events for a specific trademark (tm_*)
​
event_type
string
Filter by event type: trademark.created, trademark.updated, trademark.status_changed, trademark.retracted, trademark.corrected
​
office_code
string
Filter by office code (e.g., uspto, euipo)
​
since
string
Only return events after this ISO timestamp

​
Response

​
data
object[]
{
  "object": "list",
  "data": [
    {
      "id": 104829,
      "object": "event",
      "type": "trademark.status_changed",
      "trademark_id": "tm_8kLm2nPq",
      "office_code": "uspto",
      "created_at": "2026-03-21T06:00:00Z"
    },
    {
      "id": 104715,
      "object": "event",
      "type": "trademark.updated",
      "trademark_id": "tm_Xp4wQ7vR",
      "office_code": "euipo",
      "created_at": "2026-03-19T06:00:00Z"
    },
    {
      "id": 104602,
      "object": "event",
      "type": "trademark.created",
      "trademark_id": "tm_Ws8pL2mN",
      "office_code": "ukipo",
      "created_at": "2026-03-16T06:00:00Z"
    }
  ],
  "has_more": true,
  "pagination": {
    "cursor": "eyJpZCI6ImFiYyJ9"
  },
  "livemode": true,
  "request_id": "req_oH4yZ0aB"
}

​
Code Examples

curl "https://api.signa.so/v1/events?event_type=trademark.status_changed&office_code=uspto&since=2026-03-01T00:00:00Z" \
  -H "Authorization: Bearer sig_live_xxxxxxxxxxxx"

​
Errors

StatusTypeDescription
400validation_errorInvalid query parameters or date format
401unauthorizedMissing or invalid API key
429rate_limitedToo many requests