Skip to main content
GET
/
v1
/
trademarks
/
{id}
/
history
Trademark History
curl --request GET \
  --url https://api.signa.so/v1/trademarks/{id}/history \
  --header 'Authorization: Bearer <token>'
{
  "object": "list",
  "data": [
    {
      "id": "evt_550e8400-e29b-41d4-a716-446655440000",
      "object": "event",
      "event_date": "2024-09-18",
      "event_type": "registration",
      "description": "Registration certificate issued",
      "raw_code": "RN",
      "raw_label": "REGISTERED",
      "event_scope": "right",
      "status_after_event": "registered",
      "nice_class_number": null,
      "territory_code": null,
      "source_identifier": "uspto-statusview-2024-09-18",
      "sequence_no": 1
    },
    {
      "id": "evt_7d4e1f2a-3b8c-4d0e-9f1a-2b3c4d5e6f7a",
      "object": "event",
      "event_date": "2024-02-06",
      "event_type": "publication",
      "description": "Published for opposition",
      "raw_code": "PB",
      "raw_label": "PUBLISHED FOR OPPOSITION",
      "event_scope": "right",
      "status_after_event": "published",
      "nice_class_number": null,
      "territory_code": null,
      "source_identifier": null,
      "sequence_no": 1
    },
    {
      "id": "evt_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "object": "event",
      "event_date": "2023-04-12",
      "event_type": "filing",
      "description": "Application filed",
      "raw_code": "NA",
      "raw_label": "NEW APPLICATION",
      "event_scope": null,
      "status_after_event": "filed",
      "nice_class_number": null,
      "territory_code": null,
      "source_identifier": null,
      "sequence_no": 1
    }
  ],
  "has_more": false,
  "pagination": {
    "cursor": null
  },
  "request_id": "req_cV2nL8pQ"
}

Documentation Index

Fetch the complete documentation index at: https://docs.signa.so/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Returns the prosecution event timeline for a trademark, sourced from the office gazette and stored in the trademark_event table. Events cover filings, examinations, publications, registrations, renewals, assignments, oppositions, status changes, and ad-hoc letters from the office. Each event carries the canonical Signa event_type, the office’s raw code and label, the event scope (right, class, designation, proceeding, or other), and an optional status_after_event snapshot. Use it to build prosecution timelines, audit ownership transfers, and reconcile renewal cycles. Results are paginated and returned in reverse chronological order (newest first).

​
Path Parameters

​
id
string
required
Trademark ID prefixed with tm_ (e.g. tm_8kLm2nPq).

​
Query Parameters

​
event_type
string
Filter by one or more canonical event type codes, comma-separated. Example: event_type=registration,renewal. Use the List Event Types endpoint for the full enum.
​
event_scope
string
Filter by event scope. One of right, class, designation, proceeding, other.
​
event_date_gte
string
Earliest event date (inclusive), ISO YYYY-MM-DD.
​
event_date_lt
string
Latest event date (exclusive), ISO YYYY-MM-DD.
​
limit
integer
default:"20"
Page size, between 1 and 100.
​
cursor
string
Opaque cursor returned in the previous response’s pagination.cursor.

​
Response

​
object
string
Always list.
​
data
object[]
​
has_more
boolean
Whether more events are available.
​
pagination
object
Cursor for the next page.
​
request_id
string
Unique request identifier for support and debugging.
{
  "object": "list",
  "data": [
    {
      "id": "evt_550e8400-e29b-41d4-a716-446655440000",
      "object": "event",
      "event_date": "2024-09-18",
      "event_type": "registration",
      "description": "Registration certificate issued",
      "raw_code": "RN",
      "raw_label": "REGISTERED",
      "event_scope": "right",
      "status_after_event": "registered",
      "nice_class_number": null,
      "territory_code": null,
      "source_identifier": "uspto-statusview-2024-09-18",
      "sequence_no": 1
    },
    {
      "id": "evt_7d4e1f2a-3b8c-4d0e-9f1a-2b3c4d5e6f7a",
      "object": "event",
      "event_date": "2024-02-06",
      "event_type": "publication",
      "description": "Published for opposition",
      "raw_code": "PB",
      "raw_label": "PUBLISHED FOR OPPOSITION",
      "event_scope": "right",
      "status_after_event": "published",
      "nice_class_number": null,
      "territory_code": null,
      "source_identifier": null,
      "sequence_no": 1
    },
    {
      "id": "evt_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "object": "event",
      "event_date": "2023-04-12",
      "event_type": "filing",
      "description": "Application filed",
      "raw_code": "NA",
      "raw_label": "NEW APPLICATION",
      "event_scope": null,
      "status_after_event": "filed",
      "nice_class_number": null,
      "territory_code": null,
      "source_identifier": null,
      "sequence_no": 1
    }
  ],
  "has_more": false,
  "pagination": {
    "cursor": null
  },
  "request_id": "req_cV2nL8pQ"
}

​
Code Examples

curl -G "https://api.signa.so/v1/trademarks/tm_8kLm2nPq/history" \
  -H "Authorization: Bearer sig_YOUR_KEY_HERE" \
  --data-urlencode "event_type=registration,renewal" \
  --data-urlencode "limit=20"

​
Errors

StatusTypeDescription
400validation_errorInvalid id format, malformed date, or event_date_gte greater than event_date_lt
401unauthorizedMissing or invalid API key
403forbiddenAPI key lacks the trademarks:read scope
404not_foundTrademark ID does not exist
429rate_limitedRate limit exceeded
  • Get Trademark — current trademark data (the ?include=history parameter is not supported on the detail endpoint; use this sub-resource endpoint to fetch event history)
  • List Event Types — canonical event type enum
  • Trademark Changes — version-level field-by-field change log