Skip to main content
GET
/
v1
/
trademarks
/
{id}
/
history
Trademark History
curl --request GET \
  --url https://api.example.com/v1/trademarks/{id}/history
{
  "object": "list",
  "data": [
    {
      "id": "evt_Mn4pQ8rS",
      "type": "filing",
      "label": "Application Filed",
      "date": "2023-04-12",
      "description": "New application for registration",
      "source": "gazette"
    },
    {
      "id": "evt_Kj7nR3mP",
      "type": "examination",
      "label": "Assigned to Examiner",
      "date": "2023-08-22",
      "description": null,
      "source": "gazette"
    },
    {
      "id": "evt_Lp2qS9tV",
      "type": "publication",
      "label": "Published for Opposition",
      "date": "2024-02-06",
      "description": "Published in Official Gazette",
      "source": "gazette"
    },
    {
      "id": "evt_Wn5kT4uX",
      "type": "registration",
      "label": "Registration Issued",
      "date": "2024-09-18",
      "description": "Certificate of Registration issued",
      "source": "gazette"
    }
  ],
  "has_more": false,
  "pagination": {
    "cursor": null
  },
  "livemode": true,
  "request_id": "req_cV2nL8pQ"
}

​
Overview

Returns the complete chronological event history for a trademark, including filing, examination, publication, registration, renewals, assignments, and status changes. Each event includes the date, event type, and any associated details from the office gazette. Use this endpoint to build prosecution timelines, audit ownership transfers, or track renewal history.

​
Path Parameters

​
id
string
required
Trademark ID (e.g., tm_8kLm2nPq)

​
Query Parameters

​
limit
integer
default:"50"
Items per page (max 100)
​
cursor
string
Pagination cursor from previous response
​
event_type
string
Filter by event type (e.g., status_change, assignment, renewal, opposition)

​
Response

​
data
object[]
{
  "object": "list",
  "data": [
    {
      "id": "evt_Mn4pQ8rS",
      "type": "filing",
      "label": "Application Filed",
      "date": "2023-04-12",
      "description": "New application for registration",
      "source": "gazette"
    },
    {
      "id": "evt_Kj7nR3mP",
      "type": "examination",
      "label": "Assigned to Examiner",
      "date": "2023-08-22",
      "description": null,
      "source": "gazette"
    },
    {
      "id": "evt_Lp2qS9tV",
      "type": "publication",
      "label": "Published for Opposition",
      "date": "2024-02-06",
      "description": "Published in Official Gazette",
      "source": "gazette"
    },
    {
      "id": "evt_Wn5kT4uX",
      "type": "registration",
      "label": "Registration Issued",
      "date": "2024-09-18",
      "description": "Certificate of Registration issued",
      "source": "gazette"
    }
  ],
  "has_more": false,
  "pagination": {
    "cursor": null
  },
  "livemode": true,
  "request_id": "req_cV2nL8pQ"
}

​
Code Examples

curl https://api.signa.so/v1/trademarks/tm_8kLm2nPq/history \
  -H "Authorization: Bearer sig_live_xxxxxxxxxxxx"

​
Errors

StatusTypeDescription
400validation_errorInvalid query parameters
401unauthorizedMissing or invalid API key
404not_foundTrademark ID does not exist
429rate_limitedToo many requests