Skip to main content
GET
/
v1
/
firms
/
{id}
Get Firm
curl --request GET \
  --url https://api.example.com/v1/firms/{id}
{
  "id": "firm_abc123",
  "object": "firm",
  "name": "Smith & Partners LLP",
  "display_name": "Smith & Partners",
  "aliases": ["Smith Partners", "S&P LLP"],
  "stats": {
    "trademark_count": 4521,
    "registered_count": 3890,
    "attorney_count": 23,
    "top_clients": [
      { "owner_id": "own_abc", "name": "Acme Corp", "mark_count": 312 }
    ],
    "avg_prosecution_days": 298
  },
  "livemode": true,
  "request_id": "req_xyz789"
}

​
Path Parameters

​
id
string
required
Firm ID (e.g., firm_abc123)

​
Response

{
  "id": "firm_abc123",
  "object": "firm",
  "name": "Smith & Partners LLP",
  "display_name": "Smith & Partners",
  "aliases": ["Smith Partners", "S&P LLP"],
  "stats": {
    "trademark_count": 4521,
    "registered_count": 3890,
    "attorney_count": 23,
    "top_clients": [
      { "owner_id": "own_abc", "name": "Acme Corp", "mark_count": 312 }
    ],
    "avg_prosecution_days": 298
  },
  "livemode": true,
  "request_id": "req_xyz789"
}