Skip to main content
GET
List Firms

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

q
string
Case-insensitive substring search on firm name.
country_code
string
ISO 3166-1 alpha-2 country code filter.
min_attorneys
integer
Minimum number of attorneys at the firm.
min_filings
integer
Minimum number of trademark filings handled.
sort
string
default:"-trademark_count"
Sort field. One of -trademark_count, trademark_count, -attorney_count, attorney_count, -grant_rate, grant_rate, -name, name.
limit
integer
default:"20"
Page size (1-50).
cursor
string
Pagination cursor from a previous response.

Response

data
object[]
Array of firm summary records.
data[].id
string
Firm ID (firm_...).
data[].name
string
Display name of the firm.
data[].canonical_name
string
Normalized name used for entity resolution.
data[].country_code
string
Two-letter country code.
data[].attorney_count
integer
Number of distinct attorneys at the firm.
data[].trademark_count
integer
Total trademarks handled by the firm’s attorneys. Counts marks: a Madrid IR family counts once, matching the default grouped GET /v1/trademarks listings.
data[].active_count
integer
Count of active trademarks (registered + pending). Always present; 0 when stats not yet computed.
data[].grant_rate
number
Share of concluded prosecutions (registered + expired + cancelled) that were ever granted (0-1).
data[].latest_filing
string
ISO date of the most recent filing handled.
data[].created_at
string
ISO 8601 timestamp when this firm record was created.

Code Examples

Errors