List Offices

List all supported trademark offices

GET /v1/offices

List Offices

cURL

curl --request GET \
  --url https://api.signa.so/v1/offices \
  --header 'Authorization: Bearer <token>'

{
  "object": "list",
  "data": [
    {
      "code": "uspto",
      "object": "office",
      "name": "United States Patent and Trademark Office",
      "jurisdiction_code": "US",
      "website_url": "https://www.uspto.gov",
      "source_format": "dtd_v2",
      "status": "live",
      "update_cadence": "daily",
      "total_marks": 1547832,
      "last_synced_at": "2026-03-24T06:00:00.000Z",
      "last_sync_status": "completed"
    },
    {
      "code": "euipo",
      "object": "office",
      "name": "European Union Intellectual Property Office",
      "jurisdiction_code": "EU",
      "website_url": "https://euipo.europa.eu",
      "source_format": "json",
      "status": "live",
      "update_cadence": "daily",
      "total_marks": 892451,
      "last_synced_at": "2026-03-24T06:00:00.000Z",
      "last_sync_status": "completed"
    }
  ],
  "has_more": false,
  "request_id": "req_xyz789"
}

Response

Returns the trademark offices that are currently shipping data on the Signa platform. Offices whose connectors are still in development are omitted from this response.

object · string

Always "list"

data · object[]

Show Office object

code · string

Office code (e.g., uspto, euipo)

object · string

Always "office"

name · string

Full office name

jurisdiction_code · string

ISO 2-letter jurisdiction code (e.g., US, EU)

website_url · string | null

Office website URL

source_format · string | null

Data format used by the connector (e.g., st96_xml, dtd_v2)

status · string

Availability status. live means the connector is shipping data normally; paused means it is temporarily offline (for example while upstream is unreachable)

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 number of trademark records ingested from this office

last_synced_at · string | null

ISO timestamp of last successful sync

last_sync_status · string | null

Status of the last sync run (e.g., completed, failed)

has_more · boolean

Always false (offices are not paginated)

request_id · string

Unique request identifier

{
  "object": "list",
  "data": [
    {
      "code": "uspto",
      "object": "office",
      "name": "United States Patent and Trademark Office",
      "jurisdiction_code": "US",
      "website_url": "https://www.uspto.gov",
      "source_format": "dtd_v2",
      "status": "live",
      "update_cadence": "daily",
      "total_marks": 1547832,
      "last_synced_at": "2026-03-24T06:00:00.000Z",
      "last_sync_status": "completed"
    },
    {
      "code": "euipo",
      "object": "office",
      "name": "European Union Intellectual Property Office",
      "jurisdiction_code": "EU",
      "website_url": "https://euipo.europa.eu",
      "source_format": "json",
      "status": "live",
      "update_cadence": "daily",
      "total_marks": 892451,
      "last_synced_at": "2026-03-24T06:00:00.000Z",
      "last_sync_status": "completed"
    }
  ],
  "has_more": false,
  "request_id": "req_xyz789"
}