Trademark Source

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

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

fetch('https://api.signa.so/v1/trademarks/{id}/source', 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}/source",
  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}/source"

	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))

}

require 'uri'
require 'net/http'

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

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": "trademark_source",
  "trademark_id": "tm_abc123",
  "office_code": "US",
  "observed_at": "2026-04-09T03:18:42Z",
  "source_format": "xml_dtd",
  "source_response_type": "daily_bulk",
  "source_locator": "apc20260408-20260408-01.zip",
  "payload_hash": "sha256:8f2a..."
}

{
  "object": "trademark_source",
  "trademark_id": "tm_abc123",
  "office_code": "US",
  "observed_at": "2026-04-09T03:18:42Z",
  "source_format": "bulk_xml",
  "source_response_type": null,
  "source_locator": null,
  "payload_hash": "sha256:8f2a..."
}

GET

trademarks

{id}

source

Trademark Source

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

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

fetch('https://api.signa.so/v1/trademarks/{id}/source', 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}/source",
  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}/source"

	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))

}

require 'uri'
require 'net/http'

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

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": "trademark_source",
  "trademark_id": "tm_abc123",
  "office_code": "US",
  "observed_at": "2026-04-09T03:18:42Z",
  "source_format": "xml_dtd",
  "source_response_type": "daily_bulk",
  "source_locator": "apc20260408-20260408-01.zip",
  "payload_hash": "sha256:8f2a..."
}

{
  "object": "trademark_source",
  "trademark_id": "tm_abc123",
  "office_code": "US",
  "observed_at": "2026-04-09T03:18:42Z",
  "source_format": "bulk_xml",
  "source_response_type": null,
  "source_locator": null,
  "payload_hash": "sha256:8f2a..."
}

Overview

Returns provenance metadata for the latest raw-record version of a trademark: which office produced the data, when Signa observed it, the source format, and a content hash. Use this for auditing data lineage, verifying freshness, or proving where a particular field value originated. For some records, no raw-record version is stored. In that case the endpoint falls back to the source metadata stored directly on the trademark record: the response is still 200 OK but uses a reduced field set. source_format is synthesized as bulk_xml, source_response_type is null, and source_locator may be null. Clients should tolerate these reduced values rather than treating the response as an error. The endpoint only returns 404 when the trademark itself does not exist. This endpoint returns a single record. There is no pagination.

Path Parameters

string

required

Trademark ID (tm_...).

Response

string

Always trademark_source.

string

Echo of the requested trademark ID.

string | null

Uppercase ST.3 office code (e.g. US, EM); null if unresolvable (fail-closed). Legacy lowercase codes (e.g. uspto, and eu for EUIPO) are accepted as permanent aliases.

string

ISO 8601 timestamp when Signa fetched and parsed this version of the source record.

string

Source data format (e.g. xml_st96, xml_dtd, json).

string

Provider response classification, when known (e.g. daily_bulk, tsdr_api, weekly_zip).

string

Reference back to the originating file or URL (e.g. bulk file name, API endpoint path). May be null when no raw-record version is stored for this trademark.

string

SHA-256 hash of the raw payload, used for change detection and de-duplication.

{
  "object": "trademark_source",
  "trademark_id": "tm_abc123",
  "office_code": "US",
  "observed_at": "2026-04-09T03:18:42Z",
  "source_format": "xml_dtd",
  "source_response_type": "daily_bulk",
  "source_locator": "apc20260408-20260408-01.zip",
  "payload_hash": "sha256:8f2a..."
}

{
  "object": "trademark_source",
  "trademark_id": "tm_abc123",
  "office_code": "US",
  "observed_at": "2026-04-09T03:18:42Z",
  "source_format": "bulk_xml",
  "source_response_type": null,
  "source_locator": null,
  "payload_hash": "sha256:8f2a..."
}

Code Examples

curl "https://api.signa.so/v1/trademarks/tm_abc123/source" \
  -H "Authorization: Bearer sig_YOUR_KEY"

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

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

const source = await signa.trademarks.source("tm_abc123");
console.log(source.observed_at, source.source_format);

Errors

Status	Type	Description
400	`validation_error`	Invalid trademark ID format
401	`unauthorized`	Missing or invalid API key
404	`not_found`	Trademark not found (the endpoint falls back to trademark-record metadata when no raw-record version exists, so it does not 404 for that case)
429	`rate_limited`	Too many requests

See Errors for the full envelope.

Get Trademark: current parsed detail for the mark
Trademark Changes: diff history across versions
Data Freshness: how often each office is refreshed

Trademark Media Trademark Proceedings

Overview

Trademarks

Parties

Records

Monitoring

Reference

Analytics

Bulk & Sync

Administration

SDK

Trademark Source

Overview

Path Parameters

Response

Code Examples

Errors

​Overview

​Path Parameters

​Response

​Code Examples

​Errors

​Related Endpoints

Overview

Path Parameters

Response

Code Examples

Errors

Related Endpoints