> ## 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.
# List Offices
> List all supported trademark offices
## Overview
Returns the trademark offices that are currently live on the Signa platform, with per-office sync metadata: update cadence, total marks, last successful sync time, and field coverage percentages. Offices that are not yet live are omitted from this response.
## Query Parameters
Max results per page (max 500).
Pagination cursor, the office `code` of the last item on the previous page.
## Response
This endpoint is publicly cacheable, so the response never includes `request_id`.
Always `list`.
Uppercase ST.3 office code, e.g. `US`, `EM`. Legacy lowercase codes (e.g. `uspto`, and `eu` for EUIPO) are accepted as permanent aliases on requests.
Always `office`.
The pre-ST.3 internal office code (e.g. `uspto`). Accepted as a permanent request alias.
WIPO ST.3 code — equal to `code`; kept for the transition.
Full office name.
Name of the office's country or region.
ISO jurisdiction code for this office, e.g. `US`, `EU`.
Office website URL.
`live` when the office is shipping data normally, `paused` when it is temporarily offline.
How often this office's data is refreshed: `daily`, `weekly`, `monthly`, `on_demand`, or `null` when not yet scheduled.
Total trademark records currently held for this office.
ISO 8601 timestamp of the last successful data sync, or `null`.
Per-field completeness percentages for this office, rounded from 0 to 100. `null` means coverage has not been computed yet.
Records with image media.
Records with goods/services text on classifications.
Records with Vienna or USPTO design search codes.
Records with a publication date.
Records with a registration number.
Records with a registration date.
Records with an expiry date.
Records with priority-claim data.
Records with seniority-claim data.
Records with filing-basis data.
Records with first-use dates.
Records linked to at least one attorney/representative.
Records linked to at least one owner.
Records with a status effective date.
ISO 8601 timestamp of the stats run that computed `coverage`, or `null`.
Whether more pages are available.
Cursor for the next page, or `null` on the last page.
```json theme={null}
{
"object": "list",
"data": [
{
"code": "EM",
"object": "office",
"legacy_code": "euipo",
"st3_code": "EM",
"name": "European Union Intellectual Property Office",
"country_name": "European Union",
"jurisdiction_code": "EU",
"website_url": "https://euipo.europa.eu",
"status": "live",
"update_cadence": "daily",
"total_marks": 3202739,
"last_synced_at": "2026-07-06T07:03:32.937Z",
"coverage": {
"images": 64,
"goods_services_text": 76,
"design_codes": 15,
"publication_date": 81,
"registration_number": 94,
"registration_date": 92,
"expiry_date": 88,
"priority_claims": 7,
"seniority_claims": 3,
"filing_basis": 31,
"first_use_date": 24,
"attorney_linkage": 68,
"owner_linkage": 99,
"status_effective_date": 73
},
"coverage_computed_at": "2026-07-06T08:00:00.000Z"
},
{
"code": "US",
"object": "office",
"legacy_code": "uspto",
"st3_code": "US",
"name": "United States Patent and Trademark Office",
"country_name": "United States of America",
"jurisdiction_code": "US",
"website_url": "https://www.uspto.gov",
"status": "live",
"update_cadence": "daily",
"total_marks": 14175925,
"last_synced_at": "2026-07-06T13:04:22.321Z",
"coverage": null,
"coverage_computed_at": null
}
],
"has_more": true,
"pagination": { "cursor": "US" }
}
```
## Code Examples
```bash cURL theme={null}
curl "https://api.signa.so/v1/offices?limit=10" \
-H "Authorization: Bearer sig_YOUR_KEY"
```
```typescript TypeScript theme={null}
import { Signa } from "@signa-so/sdk";
const signa = new Signa({ api_key: process.env.SIGNA_API_KEY });
const offices = await signa.references.offices();
for (const office of offices.data) {
console.log(office.code, office.total_marks, office.last_synced_at);
}
```
## Errors
| Status | Type | Description |
| ------ | -------------- | ------------------------------------------- |
| 401 | `unauthorized` | Missing or invalid API key |
| 403 | `forbidden` | API key missing the `trademarks:read` scope |
| 429 | `rate_limited` | Too many requests |
## Related Endpoints
* [Get Office](/api-reference/reference/get-office), single office detail
* [List Jurisdictions](/api-reference/reference/list-jurisdictions), jurisdiction overview
* [Data Freshness](/guides/data-freshness), sync cadence and coverage by office