Skip to main content
GET
/
v1
/
offices
/
{code}
Get Office
curl --request GET \
  --url https://api.signa.so/v1/offices/{code} \
  --header 'Authorization: Bearer <token>'
{
  "code": "uspto",
  "object": "office",
  "name": "United States Patent and Trademark Office",
  "jurisdiction_code": "US",
  "website_url": "https://www.uspto.gov",
  "source_format": "xml_dtd",
  "connector_version": "2.4.1",
  "status": "live",
  "update_cadence": "daily",
  "total_marks": 9824123,
  "last_synced_at": "2026-04-09T03:14:09Z",
  "last_sync_status": "success"
}

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 a single trademark office record, including connector version, update cadence, total marks ingested, and the last successful sync timestamp. Use this when you need to display data freshness for a specific office. Offices whose connectors are still in development return 404.

​
Path Parameters

​
code
string
required
Lowercase office code (e.g. uspto, euipo, wipo).

​
Response

​
code
string
Lowercase office code.
​
object
string
Always office.
​
name
string
Full office name.
​
jurisdiction_code
string
Primary jurisdiction code (e.g. US).
​
website_url
string
Office website URL.
​
source_format
string
Connector source format (e.g. xml_st96, xml_dtd).
​
connector_version
string
Connector version string.
​
status
string
Availability status. live means the connector is shipping data normally; paused means it is temporarily offline.
​
update_cadence
string | null
How often this office’s data is refreshed. One of daily, weekly, monthly, on_demand, or null when the cadence is not yet defined.
​
total_marks
integer
Total trademarks currently in Signa for this office.
​
last_synced_at
string
ISO 8601 timestamp of the last successful sync.
​
last_sync_status
string
Status of the last sync (success, failed, partial).
{
  "code": "uspto",
  "object": "office",
  "name": "United States Patent and Trademark Office",
  "jurisdiction_code": "US",
  "website_url": "https://www.uspto.gov",
  "source_format": "xml_dtd",
  "connector_version": "2.4.1",
  "status": "live",
  "update_cadence": "daily",
  "total_marks": 9824123,
  "last_synced_at": "2026-04-09T03:14:09Z",
  "last_sync_status": "success"
}

​
Code Examples

curl "https://api.signa.so/v1/offices/uspto" \
  -H "Authorization: Bearer sig_YOUR_KEY_HERE"

​
Errors

StatusTypeDescription
401unauthorizedMissing or invalid API key
404not_foundOffice code not recognized