Skip to main content
GET
/
v1
/
attorneys
/
{id}
/
clients
Attorney Clients
curl --request GET \
  --url https://api.example.com/v1/attorneys/{id}/clients
{
  "object": "list",
  "data": [
    {
      "id": "own_AcmeCo",
      "object": "owner",
      "canonical_name": "Acme Corporation",
      "country_code": "US",
      "entity_type": "corporation",
      "shared_trademark_count": 47
    }
  ],
  "has_more": false,
  "pagination": { "cursor": null },
  "livemode": true,
  "request_id": "req_xyz"
}

​
Overview

Returns the owners that an attorney has represented on trademark filings. Derived from the intersection of trademark_owners and trademark_attorneys. Each row reports the number of marks shared between the attorney and that owner. Sorted by shared_trademark_count descending.

​
Path Parameters

​
id
string
required
Attorney ID (att_...).

​
Query Parameters

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

​
Response

​
data
object[]
Array of client owner summary records.
​
data[].id
string
Owner ID (own_...).
​
data[].canonical_name
string
Normalized owner name.
​
data[].country_code
string
Owner country code.
​
data[].entity_type
string
Owner entity type (e.g. corporation, individual, partnership).
​
data[].shared_trademark_count
integer
Number of trademarks where this attorney represents this owner.
{
  "object": "list",
  "data": [
    {
      "id": "own_AcmeCo",
      "object": "owner",
      "canonical_name": "Acme Corporation",
      "country_code": "US",
      "entity_type": "corporation",
      "shared_trademark_count": 47
    }
  ],
  "has_more": false,
  "pagination": { "cursor": null },
  "livemode": true,
  "request_id": "req_xyz"
}

​
Code Examples

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

​
Errors

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