Skip to main content
GET
/
v1
/
attorneys
List Attorneys
curl --request GET \
  --url https://api.example.com/v1/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
    }
  ],
  "has_more": true,
  "pagination": { "cursor": "eyJpZCI6Imp..." },
  "livemode": true,
  "request_id": "req_xyz"
}

​
Overview

Returns a paginated list of attorneys derived from the trademark records Signa has ingested. Use this for attorney lookup, prosecution counsel discovery, or building a competitive view of who is filing for whom. Search supports fuzzy name matching via pg_trgm.

​
Query Parameters

​
q
string
Fuzzy attorney name search.
​
firm_id
string
Restrict to attorneys at a specific firm (firm_...).
​
country_code
string
ISO 3166-1 alpha-2 country code filter.
​
sort
string
default:"-trademark_count"
Sort field. One of -trademark_count, trademark_count, -name, name.
​
limit
integer
default:"20"
Page size (1-50).
​
cursor
string
Pagination cursor from a previous response.

​
Response

​
data
object[]
Array of attorney summary records.
​
data[].id
string
Attorney ID (att_...).
​
data[].canonical_name
string
Normalized attorney name.
​
data[].firm_name
string
Affiliated firm name when known.
​
data[].country_code
string
Two-letter country code.
​
data[].trademark_count
integer
Total trademarks attributed to this attorney.
{
  "object": "list",
  "data": [
    {
      "id": "att_3kPq9X",
      "object": "attorney",
      "canonical_name": "Jane R. Smith",
      "firm_name": "Smith & Associates LLP",
      "country_code": "US",
      "trademark_count": 1284
    }
  ],
  "has_more": true,
  "pagination": { "cursor": "eyJpZCI6Imp..." },
  "livemode": true,
  "request_id": "req_xyz"
}

​
Code Examples

curl "https://api.signa.so/v1/attorneys?q=smith&country_code=US&sort=-trademark_count&limit=20" \
  -H "Authorization: Bearer sig_live_YOUR_KEY_HERE"

​
Errors

StatusTypeDescription
400validation_errorInvalid query parameter
401unauthorizedMissing or invalid API key
429rate_limitedToo many requests