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",
    "avg_prosecution_days": 312,
    "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"
}

GET

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",
    "avg_prosecution_days": 312,
    "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

string

required

Attorney ID prefixed with att_ (e.g. att_abc123).

Response

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

Show Alias object

name

string

Alternate name observed in source data.

type

string

Alias source (e.g. office-reported, normalized).

source_office

string | null

Office that produced this alias.

identifiers

object[]

Alternate office-issued identifiers (bar numbers, attorney docket IDs).

stats

object | null

Show Stats object

trademark_count

integer

Total trademarks represented.

registered_count

integer

Currently registered marks.

pending_count

integer

Marks in pending status.

expired_count

integer

Expired marks.

cancelled_count

integer

Cancelled marks.

abandoned_count

integer

Abandoned marks.

registration_rate

number

Share of marks that reached registration.

abandonment_rate

number

Share of marks abandoned.

jurisdiction_count

integer

Distinct jurisdictions.

earliest_filing

string | null

Earliest filing date observed.

latest_filing

string | null

Latest filing date observed.

avg_prosecution_days

number | null

Average prosecution duration in days.

computed_at

string

Timestamp when the stats snapshot was computed.

The ranked-list fields top_classes, top_clients, jurisdictions, and yearly_trend were removed from the attorney stats response in April 2026. To enumerate an attorney’s clients, use the dedicated GET /v1/attorneys/:id/clients endpoint.

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",
    "avg_prosecution_days": 312,
    "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

Status	Type	Description
400	`validation_error`	Invalid `id` format
401	`unauthorized`	Missing or invalid API key
403	`forbidden`	API key lacks the `trademarks:read` scope
404	`not_found`	Attorney ID does not exist
410	`entity_merged`	Attorney was merged into another entity. The new ID is returned in the error detail.
429	`rate_limited`	Rate limit exceeded

List Attorneys — filtered listing of attorneys
Attorney Trademarks — portfolio of marks an attorney represents
Attorney Clients — owners represented by an attorney
Get Firm — detail for the linked firm

List Attorneys Attorney Trademarks

​Overview

​Path Parameters

​Response

​Code Examples

​Errors

​Related Endpoints

Overview

Path Parameters

Response

Code Examples

Errors

Related Endpoints