Get Office
Offices & Jurisdictions
Get Office
Retrieve a single trademark office with sync metadata
GET
Get Office
Overview
Returns a single trademark office record: update cadence, total marks ingested, last successful sync timestamp, and field coverage percentages. Use this to display data freshness and data completeness for a specific office. Offices that are not live return404.
Path Parameters
Lowercase office code, e.g.
uspto, euipo, wipo. This is not the jurisdiction code, use Get Jurisdiction for ISO codes like US or EU.Response
This endpoint is publicly cacheable, so the response never includesrequest_id. The object has the same fields as an item in List Offices.
Lowercase office code.
Always
office.Full office name.
Name of the office’s country or region.
ISO jurisdiction code for this office, e.g.
US.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. See List Offices for the full field list.
ISO 8601 timestamp of the stats run that computed
coverage, or null.Code Examples
Errors
| Status | Type | Description |
|---|---|---|
| 401 | unauthorized | Missing or invalid API key |
| 403 | forbidden | API key missing the trademarks:read scope |
| 404 | not_found | Office code not recognized, or the office is not live |
Related Endpoints
- List Offices, all supported offices
- Get Jurisdiction
- Data Freshness