Skip to main content
GET
/
v1
/
trademarks
/
{id}
/
proceedings
Trademark Proceedings
curl --request GET \
  --url https://api.example.com/v1/trademarks/{id}/proceedings
{
  "object": "list",
  "data": [
    {
      "id": "prc_8nM3pQ",
      "proceeding_type": "opposition",
      "proceeding_number": "91265432",
      "status": "pending",
      "filed_date": "2025-11-04",
      "decision_date": null,
      "decision_outcome": null,
      "parties": [
        {
          "owner_id": "own_AcmeOpp",
          "name": "Acme Holdings Ltd.",
          "role": "opponent",
          "country_code": "GB"
        },
        {
          "owner_id": "own_TargetCo",
          "name": "Target Inc.",
          "role": "respondent",
          "country_code": "US"
        }
      ],
      "contested_classes": [9, 42],
      "description": null
    }
  ],
  "has_more": false,
  "pagination": { "cursor": null },
  "livemode": true,
  "request_id": "req_abc"
}

​
Overview

Lists all proceedings (oppositions, cancellations, revocations, appeals, court actions, and other disputes) that involve the specified trademark. Each item includes the parties, status, and decision outcome when available. Sorted by filed_date descending.

​
Path Parameters

​
id
string
required
Trademark ID (tm_...).

​
Query Parameters

​
proceeding_type
string
Filter by proceeding type. One of opposition, cancellation, revocation, invalidity, appeal, non_use_removal, court_action, other.
​
status
string
Filter by status. One of pending, decided_granted, decided_rejected, withdrawn, settled, suspended, partial, other.
​
limit
integer
default:"20"
Page size (1-100).
​
cursor
string
Pagination cursor from a previous response.

​
Response

​
data
object[]
Array of proceeding records.
​
data[].id
string
Proceeding ID (prc_...).
​
data[].proceeding_type
string
Type of proceeding.
​
data[].proceeding_number
string
Office-issued proceeding identifier when available.
​
data[].status
string
Current status.
​
data[].filed_date
string
ISO date the proceeding was initiated.
​
data[].decision_date
string
ISO date of the decision when concluded.
​
data[].decision_outcome
string
Outcome string when decided.
​
data[].parties
object[]
Array of parties to the proceeding. Each party has owner_id, name, role (opponent, petitioner, respondent, intervener, other), and country_code.
​
data[].contested_classes
integer[]
Nice classes contested in the proceeding, when known.
​
data[].description
string
Free-text summary, when provided by the office.
{
  "object": "list",
  "data": [
    {
      "id": "prc_8nM3pQ",
      "proceeding_type": "opposition",
      "proceeding_number": "91265432",
      "status": "pending",
      "filed_date": "2025-11-04",
      "decision_date": null,
      "decision_outcome": null,
      "parties": [
        {
          "owner_id": "own_AcmeOpp",
          "name": "Acme Holdings Ltd.",
          "role": "opponent",
          "country_code": "GB"
        },
        {
          "owner_id": "own_TargetCo",
          "name": "Target Inc.",
          "role": "respondent",
          "country_code": "US"
        }
      ],
      "contested_classes": [9, 42],
      "description": null
    }
  ],
  "has_more": false,
  "pagination": { "cursor": null },
  "livemode": true,
  "request_id": "req_abc"
}

​
Code Examples

curl "https://api.signa.so/v1/trademarks/tm_abc123/proceedings?proceeding_type=opposition&status=pending" \
  -H "Authorization: Bearer sig_live_YOUR_KEY_HERE"

​
Errors

StatusTypeDescription
400validation_errorInvalid query parameter or trademark ID
401unauthorizedMissing or invalid API key
404not_foundTrademark not found
429rate_limitedToo many requests