Skip to main content
GET
/
v1
/
firms
/
{id}
/
attorneys
Firm Attorneys
curl --request GET \
  --url https://api.example.com/v1/firms/{id}/attorneys
{
  "object": "list",
  "data": [
    {
      "id": "att_3kPq9X",
      "object": "attorney",
      "canonical_name": "Jane R. Smith",
      "firm_name": "Smith & Associates LLP",
      "country_code": "US",
      "trademark_count": 1284,
      "registration_rate": 0.81,
      "latest_filing": "2026-04-08",
      "created_at": "2024-09-12T11:42:01Z",
      "updated_at": "2026-04-09T03:18:22Z"
    }
  ],
  "has_more": true,
  "pagination": { "cursor": "eyJpZCI6..." },
  "livemode": true,
  "request_id": "req_xyz"
}

Overview

Returns the attorneys associated with a firm, derived from trademark filings. Each row includes the attorney’s filing volume, registration rate, and most recent filing date so you can rank within the firm.

Path Parameters

id
string
required
Firm ID (firm_...).

Query Parameters

limit
integer
default:"20"
Page size (1-100).
cursor
string
Pagination cursor from a previous response.

Response

data
object[]
Array of attorney records at this firm.
data[].id
string
Attorney ID (att_...).
data[].canonical_name
string
Normalized attorney name.
data[].firm_name
string
Firm display name.
data[].country_code
string
Two-letter country code.
data[].trademark_count
integer
Total trademarks attributed to this attorney.
data[].registration_rate
number
Share of marks reaching registered status (0-1).
data[].latest_filing
string
ISO date of the most recent filing handled.
data[].created_at
string
ISO 8601 record creation timestamp.
data[].updated_at
string
ISO 8601 last-updated timestamp.
{
  "object": "list",
  "data": [
    {
      "id": "att_3kPq9X",
      "object": "attorney",
      "canonical_name": "Jane R. Smith",
      "firm_name": "Smith & Associates LLP",
      "country_code": "US",
      "trademark_count": 1284,
      "registration_rate": 0.81,
      "latest_filing": "2026-04-08",
      "created_at": "2024-09-12T11:42:01Z",
      "updated_at": "2026-04-09T03:18:22Z"
    }
  ],
  "has_more": true,
  "pagination": { "cursor": "eyJpZCI6..." },
  "livemode": true,
  "request_id": "req_xyz"
}

Code Examples

curl "https://api.signa.so/v1/firms/firm_2kLm9X/attorneys?limit=20" \
  -H "Authorization: Bearer sig_live_YOUR_KEY_HERE"

Errors

StatusTypeDescription
400validation_errorInvalid firm ID
401unauthorizedMissing or invalid API key
404not_foundFirm not found
429rate_limitedToo many requests