Trademark Changes

Version-level diff history showing what changed on a trademark and when

GET /v1/trademarks/{id}/changes

Trademark Changes

cURL

curl --request GET \
  --url https://api.signa.so/v1/trademarks/{id}/changes \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.signa.so/v1/trademarks/{id}/changes"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.signa.so/v1/trademarks/{id}/changes', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.signa.so/v1/trademarks/{id}/changes",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.signa.so/v1/trademarks/{id}/changes"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.signa.so/v1/trademarks/{id}/changes")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.signa.so/v1/trademarks/{id}/changes")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "object": "list",
  "data": [
    {
      "version": 4,
      "change_type": "updated",
      "changed_fields": ["status_stage", "status_reason"],
      "old_values": { "status_stage": "examining", "status_reason": null },
      "new_values": { "status_stage": "registered", "status_reason": null },
      "source_data_date": "2025-08-12",
      "office_code": "US",
      "created_at": "2025-08-13T03:14:09Z"
    }
  ],
  "has_more": false,
  "pagination": { "cursor": null },
  "request_id": "req_xyz"
}

Overview

Returns the diff log from the change-history ledger for a single mark, reverse chronological by default. Each entry captures the fields that changed in one update, the old and new values, and the source data date. Use this when you need an audit trail of how a record evolved (status flips, owner changes, classification edits) rather than the office event timeline you get from /history.

Path Parameters

id · string · required

Trademark ID (tm_...).

Query Parameters

changed_field · string

Restrict to versions whose changed_fields array includes this field name. Parent-field changes use snake_case field names (e.g. status_stage, mark_text_primary, expiry_date). Child-entity changes use related entity types (classifications, owners, attorneys, events).

sort · string · default: "-changed_at"

Sort order. One of -changed_at (newest first, default) or changed_at (oldest first).

limit · integer · default: "20"

Page size (1-100).

cursor · string

Opaque pagination cursor from a previous response.

Response

data · object[]

Array of change records ordered by created_at.

data[].version · integer

Monotonically increasing version number for this trademark.

data[].change_type · string

Change classification (e.g. created, updated, corrected).

data[].changed_fields · string[]

Names of fields touched in this version.

data[].old_values · object

Field-keyed object of values before the change. null for the initial version.

data[].new_values · object

Field-keyed object of values after the change.

data[].source_data_date · string

ISO date the source office published this version, when known.

data[].office_code · string | null

Uppercase WIPO ST.3 office code that produced the change (e.g. US, EM). Null if unresolvable (fail-closed).

data[].created_at · string

ISO 8601 timestamp when Signa observed and persisted the change.

{
  "object": "list",
  "data": [
    {
      "version": 4,
      "change_type": "updated",
      "changed_fields": ["status_stage", "status_reason"],
      "old_values": { "status_stage": "examining", "status_reason": null },
      "new_values": { "status_stage": "registered", "status_reason": null },
      "source_data_date": "2025-08-12",
      "office_code": "US",
      "created_at": "2025-08-13T03:14:09Z"
    }
  ],
  "has_more": false,
  "pagination": { "cursor": null },
  "request_id": "req_xyz"
}

Code Examples

cURL

curl "https://api.signa.so/v1/trademarks/tm_abc123/changes?changed_field=status_stage&limit=10" \
  -H "Authorization: Bearer sig_YOUR_KEY"

import { Signa } from "@signa-so/sdk";

const signa = new Signa({ api_key: process.env.SIGNA_API_KEY });

const changes = await signa.trademarks.changes("tm_abc123", {
  changed_field: "status_stage",
  limit: 10,
});

for (const change of changes.data) {
  console.log(change.version, change.changed_fields);
}

Errors

Status	Type	Description
400	validation_error	Invalid query parameter
401	unauthorized	Missing or invalid API key
404	not_found	Trademark ID does not exist
429	rate_limited	Too many requests

See Errors for the full envelope.

Related Endpoints

• Trademark History: office event timeline (filings, publications, decisions)
• Get Trademark: current full detail
• Trademark Source: raw source provenance for the latest version