Skip to main content
GET
Retrieve Attorney
Credits: 1 per record.

Overview

Returns the full detail tier for a single attorney: canonical name, the firms its filings name, country, address, aliases, alternate identifiers (bar numbers and similar office-issued IDs), and computed practice statistics. There are no ?include= parameters on this endpoint, the full detail is always returned. If the attorney record was merged into another (entity resolution), the endpoint returns 410 entity_merged with the new ID in the error body.

Path Parameters

string
required
Attorney ID prefixed with att_ (e.g. att_3kPq9X).

Response

string
Attorney ID prefixed with att_.
string
Always attorney.
string
Display name of the attorney.
string
Normalized name used for search and deduplication.
string | null
Deprecated: use firms. Firm ID (firm_...) on the attorney’s most recent current filing (by filing date) that names a firm; null when no filing names one.
string | null
Deprecated: use firms. Display name of that firm.
object[]
Firms named on the attorney’s current filings, most trademarks first, at most 20; the firm in firm_id is added when it ranks lower. Empty when no filing names a firm. An attorney who filed with several firms lists each of them.
string | null
ISO 3166-1 alpha-2 country code.
string | null
WIPO ST.3 code of the office whose records this attorney row comes from (for example US, EM, WO). Attorney records are per office: the same person appears once per office they file at, each row with its own source_office_code.
object | null
Postal address on the attorney’s most recent current filing that carries one, in the one address shape: lines[] (verbatim), city, region, postal_code, country_code and formatted (the office’s single-string rendering, or null). Components are filled only when the office supplied them; null when no filing carries an address. For WIPO (WO), Sweden (SE) and Italy (IT) attorneys, whose older filings were stored without an attorney address, it is the address the office holds for the representative when no filing address is on record.
integer
Distinct marks represented (mark grain): a Madrid IR and its designations count once, matching the default grouped trademark listings. 0 when stats are not yet computed.
integer
Count of active trademarks (registered + pending). Always present; 0 when stats not yet computed.
object[]
object[]
Alternate office-issued identifiers (bar numbers, attorney docket IDs), each {office_code, identifier, identifier_type}.
object | null
string
ISO 8601 creation timestamp.
string
ISO 8601 last update timestamp.
string
Unique request identifier for support and debugging.
To enumerate an attorney’s clients, use the dedicated GET /v1/attorneys/:id/clients endpoint.

Code Examples