Skip to main content
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 with attorneys_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