Skip to main content
GET
Search Firms
Credits: 10 per page.

Overview

Returns a paginated list of law firms derived from attorney affiliations on ingested trademarks. Filter by country, attorney count, filing volume, and sort by activity metrics.

Recent changes

The beta ?include=stats option has been removed; always-on summary fields now carry the supported firm counts.

Query Parameters

string
Fuzzy, typo-tolerant name match. Without sort, exact names and larger portfolios rank first.
string
ISO 3166-1 alpha-2 country code filter.
integer
Minimum number of attorneys at the firm.
integer
Minimum number of trademark filings handled.
string
default:"-trademark_count"
Sort field. One of -trademark_count, trademark_count, -attorney_count, attorney_count, -grant_rate, grant_rate, -name, name.
boolean
default:"false"
When true, adds pagination.total_count. See Pagination.
integer
default:"20"
Page size, between 1 and 100.
string
Pagination cursor from a previous response.

Response

object[]
Array of firm summary records.
string
Firm ID (firm_...).
string
Display name of the firm.
string
Normalized name used for entity resolution.
string
Two-letter country code.
integer
Distinct attorneys on the current filings that name the firm.
integer
Trademarks whose filing names the firm. 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
Share of concluded prosecutions (registered + expired + cancelled) that were ever granted (0-1).
string
ISO date of the most recent filing handled.
string
ISO 8601 timestamp when this firm record was created.

Code Examples