Skip to main content
GET
Office Analytics
Credits: 100 per request. Use this endpoint to benchmark one office by registration rate, leading Nice classes, and yearly filing trend. Office codes are uppercase ST.3 (legacy lowercase codes are accepted as permanent aliases).
string
required
Uppercase ST.3 office code, for example US.

Code Examples

Response

number
Trademark records at the office. Every office record counts: a Madrid international registration counts for its own record, for each designation record, and again for any national office’s own record of a designation (for example a USPTO 79-series record), so the WO counts are records, not international registrations, and a national office’s counts include its records of Madrid designations.
number
Records per status bucket. Every status stage falls in exactly one bucket: pending is every stage before registration (opposition_period included), registered includes pending_cancellation (the mark stays on the register until the cancellation is decided), cancelled includes surrendered and invalidated, and abandoned includes withdrawn and refused. unknown_count holds the records whose status stage is unknown, so the six counts sum to total_marks.
number | null
Share of concluded matters that reached registration. Not reliable for GB: the UKIPO source leaves out most abandoned applications, so the rate reads close to 1.
array<{ class: number; count: number; pct: number }> | null
The ten most frequent Nice classes. count counts class assignments, so a record in three classes counts once in each, and pct is the class’s share of all the office’s class assignments, not the share of its records.
array<{ year: number; filed: number; registered: number; abandoned: number }> | null
One row per filing year, in trademark records like total_marks. filed counts the records filed that year; registered and abandoned count how many of those records are in that status bucket now, not what happened during the year. The current year is partial.
string
When these figures were computed. Office figures are recomputed nightly.