Get Firm
Firms
Get Firm
Retrieve a law firm profile by ID
GET
Get Firm
Overview
Returns the detail tier for a single law firm: name, canonical name, country, aliases, attorney count, trademark count, active count, grant rate, and latest filing date. Optional?include=attorneys embeds the firm’s attorneys.
Recent changes
?include=stats has been removed (beta breaking change). Firm counts remain always-on top-level fields, including the new active_count field.
If the firm 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
Firm ID prefixed with
firm_ (e.g. firm_2kLm9X).Query Parameters
string
Comma-separated relations to embed. Valid values:
attorneys: first page of attorneys at the firm withattorneys_has_more
Response
string
Firm ID prefixed with
firm_.string
Always
firm.string
Display name of the firm.
string
Normalized name used for search and deduplication.
string | null
ISO 3166-1 alpha-2 country code.
object[]
integer
Total attorneys linked to this firm.
integer
Total trademarks where this firm appears as representative. Counts marks: a Madrid IR family counts once, matching the default grouped
GET /v1/trademarks listings.integer
Count of active trademarks (registered + pending). Always present; 0 when stats not yet computed.
number | null
Share of concluded prosecutions (registered + expired + cancelled) that were ever granted.
string | null
Latest filing date observed for this firm.
string
ISO 8601 creation timestamp.
string
ISO 8601 last update timestamp.
object[]
Returned when
?include=attorneys. Paired with attorneys_has_more.string
Unique request identifier for support and debugging.
Code Examples
Errors
Related Endpoints
- List Firms: filtered listing of firms
- Firm Attorneys: attorneys at a firm
- Firm Trademarks: portfolio of marks the firm represents