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

id
string
required
Firm ID prefixed with firm_ (e.g. firm_2kLm9X).

Query Parameters

include
string
Comma-separated relations to embed. Valid values:
  • attorneys: first page of attorneys at the firm with attorneys_has_more

Response

id
string
Firm ID prefixed with firm_.
object
string
Always firm.
name
string
Display name of the firm.
canonical_name
string
Normalized name used for search and deduplication.
country_code
string | null
ISO 3166-1 alpha-2 country code.
aliases
object[]
attorney_count
integer
Total attorneys linked to this firm.
trademark_count
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.
active_count
integer
Count of active trademarks (registered + pending). Always present; 0 when stats not yet computed.
grant_rate
number | null
Share of concluded prosecutions (registered + expired + cancelled) that were ever granted.
latest_filing
string | null
Latest filing date observed for this firm.
created_at
string
ISO 8601 creation timestamp.
updated_at
string
ISO 8601 last update timestamp.
attorneys
object[]
Returned when ?include=attorneys. Paired with attorneys_has_more.
request_id
string
Unique request identifier for support and debugging.

Code Examples

Errors