Skip to main content
GET
/
v1
/
offices
/
{code}
Get Office
curl --request GET \
  --url https://api.example.com/v1/offices/{code}
{
  "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",
  "sync_enabled": true,
  "sync_schedule": "daily 03:00 UTC",
  "total_marks": 9824123,
  "last_synced_at": "2026-04-09T03:14:09Z",
  "last_sync_status": "success"
}

​
Overview

Returns a single trademark office record, including connector version, sync schedule, total marks ingested, and the last successful sync timestamp. Use this when you need to display data freshness for a specific office.

​
Path Parameters

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

​
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.
​
sync_enabled
boolean
Whether automated ingestion is enabled.
​
sync_schedule
string
Cron-style or human-readable sync schedule.
​
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",
  "sync_enabled": true,
  "sync_schedule": "daily 03:00 UTC",
  "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_live_YOUR_KEY_HERE"

​
Errors

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