Skip to main content
GET
/
v1
/
attorneys
/
{id}
Get Attorney
curl --request GET \
  --url https://api.signa.so/v1/attorneys/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "att_abc123",
  "object": "attorney",
  "name": "Jane Smith",
  "canonical_name": "JANE SMITH",
  "firm_id": "firm_def456",
  "firm_name": "Smith & Partners LLP",
  "country_code": "US",
  "address": {
    "line1": "100 Patent Way",
    "city": "Alexandria",
    "region": "VA",
    "postal_code": "22314",
    "country_code": "US"
  },
  "aliases": [
    { "name": "Jane M Smith", "type": "office_reported", "source_office": "uspto" }
  ],
  "identifiers": [
    { "type": "uspto_attorney_docket", "value": "JS-12345", "source_office": "uspto" }
  ],
  "stats": {
    "trademark_count": 342,
    "registered_count": 287,
    "pending_count": 41,
    "expired_count": 8,
    "cancelled_count": 4,
    "abandoned_count": 2,
    "registration_rate": 0.84,
    "abandonment_rate": 0.006,
    "jurisdiction_count": 7,
    "earliest_filing": "2014-03-22",
    "latest_filing": "2025-09-30",
    "top_classes": [{ "class": 9, "count": 96 }, { "class": 42, "count": 71 }],
    "jurisdictions": [{ "code": "US", "count": 287 }],
    "yearly_trend": [{ "year": 2024, "count": 38 }],
    "avg_prosecution_days": 312,
    "top_clients": [
      { "owner_id": "own_R3jK9mN2", "name": "Acme Corp", "count": 45 }
    ],
    "computed_at": "2026-04-08T14:23:11Z"
  },
  "created_at": "2023-01-11T08:00:00Z",
  "updated_at": "2026-04-08T14:23:11Z",
  "request_id": "req_xyz789"
}

​
Overview

Returns the full detail tier for a single attorney: canonical name, firm linkage, country, address, aliases, alternate identifiers (bar numbers and similar office-issued IDs), and computed practice statistics with top clients when available. There are no ?include= parameters on this endpoint, the full detail is always returned. If the attorney record was merged into another (entity resolution), the endpoint returns 410 entity_merged with the new ID in the error body.

​
Path Parameters

​
id
string
required
Attorney ID prefixed with att_ (e.g. att_abc123).

​
Response

​
id
string
Attorney ID prefixed with att_.
​
object
string
Always attorney.
​
name
string
Display name of the attorney.
​
canonical_name
string
Normalized name used for entity resolution and deduplication.
​
firm_id
string | null
Firm ID prefixed with firm_, when the attorney is linked to a firm.
​
firm_name
string | null
Convenience denormalization of the firm’s display name.
​
country_code
string | null
ISO 3166-1 alpha-2 country code.
​
address
object | null
Office address as reported by the source office.
​
aliases
object[]
​
identifiers
object[]
Alternate office-issued identifiers (bar numbers, attorney docket IDs).
​
stats
object | null
​
created_at
string
ISO 8601 creation timestamp.
​
updated_at
string
ISO 8601 last update timestamp.
​
request_id
string
Unique request identifier for support and debugging.
{
  "id": "att_abc123",
  "object": "attorney",
  "name": "Jane Smith",
  "canonical_name": "JANE SMITH",
  "firm_id": "firm_def456",
  "firm_name": "Smith & Partners LLP",
  "country_code": "US",
  "address": {
    "line1": "100 Patent Way",
    "city": "Alexandria",
    "region": "VA",
    "postal_code": "22314",
    "country_code": "US"
  },
  "aliases": [
    { "name": "Jane M Smith", "type": "office_reported", "source_office": "uspto" }
  ],
  "identifiers": [
    { "type": "uspto_attorney_docket", "value": "JS-12345", "source_office": "uspto" }
  ],
  "stats": {
    "trademark_count": 342,
    "registered_count": 287,
    "pending_count": 41,
    "expired_count": 8,
    "cancelled_count": 4,
    "abandoned_count": 2,
    "registration_rate": 0.84,
    "abandonment_rate": 0.006,
    "jurisdiction_count": 7,
    "earliest_filing": "2014-03-22",
    "latest_filing": "2025-09-30",
    "top_classes": [{ "class": 9, "count": 96 }, { "class": 42, "count": 71 }],
    "jurisdictions": [{ "code": "US", "count": 287 }],
    "yearly_trend": [{ "year": 2024, "count": 38 }],
    "avg_prosecution_days": 312,
    "top_clients": [
      { "owner_id": "own_R3jK9mN2", "name": "Acme Corp", "count": 45 }
    ],
    "computed_at": "2026-04-08T14:23:11Z"
  },
  "created_at": "2023-01-11T08:00:00Z",
  "updated_at": "2026-04-08T14:23:11Z",
  "request_id": "req_xyz789"
}

​
Code Examples

curl "https://api.signa.so/v1/attorneys/att_abc123" \
  -H "Authorization: Bearer sig_YOUR_KEY_HERE"

​
Errors

StatusTypeDescription
400validation_errorInvalid id format
401unauthorizedMissing or invalid API key
403forbiddenAPI key lacks the trademarks:read scope
404not_foundAttorney ID does not exist
410entity_mergedAttorney was merged into another entity. The new ID is returned in the error detail.
429rate_limitedRate limit exceeded