List Attorneys

curl --request GET \
  --url https://api.signa.so/v1/attorneys \
  --header 'Authorization: Bearer <token>'

{
  "object": "list",
  "data": [
    {
      "id": "att_3kPq9X",
      "object": "attorney",
      "name": "Jane R. Smith",
      "canonical_name": "JANE R SMITH",
      "firm_name": "Smith & Associates LLP",
      "country_code": "US",
      "trademark_count": 1284
    }
  ],
  "has_more": true,
  "pagination": { "cursor": "eyJpZCI6Imp..." },
  "request_id": "req_xyz"
}

GET

attorneys

List Attorneys

curl --request GET \
  --url https://api.signa.so/v1/attorneys \
  --header 'Authorization: Bearer <token>'

{
  "object": "list",
  "data": [
    {
      "id": "att_3kPq9X",
      "object": "attorney",
      "name": "Jane R. Smith",
      "canonical_name": "JANE R SMITH",
      "firm_name": "Smith & Associates LLP",
      "country_code": "US",
      "trademark_count": 1284
    }
  ],
  "has_more": true,
  "pagination": { "cursor": "eyJpZCI6Imp..." },
  "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 trigram-based fuzzy name matching.

Query Parameters

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[].name

string

Display name of the attorney.

data[].canonical_name

string

Normalized name used for entity resolution.

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",
      "name": "Jane R. Smith",
      "canonical_name": "JANE R SMITH",
      "firm_name": "Smith & Associates LLP",
      "country_code": "US",
      "trademark_count": 1284
    }
  ],
  "has_more": true,
  "pagination": { "cursor": "eyJpZCI6Imp..." },
  "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_YOUR_KEY_HERE"

Errors

Status	Type	Description
400	`validation_error`	Invalid query parameter
401	`unauthorized`	Missing or invalid API key
429	`rate_limited`	Too many requests

Get Attorney — full attorney detail
Attorney Trademarks — marks handled by an attorney
Attorney Clients — owners represented by an attorney
List Firms — search firms instead

Owner Related Entities Get Attorney

​Overview

​Query Parameters

​Response

​Code Examples

​Errors

​Related Endpoints

Overview

Query Parameters

Response

Code Examples

Errors

Related Endpoints