Trademark Proceedings

curl --request GET \
  --url https://api.signa.so/v1/trademarks/{id}/proceedings \
  --header 'Authorization: Bearer <token>'

{
  "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 },
  "request_id": "req_abc"
}

GET

trademarks

{id}

proceedings

Trademark Proceedings

curl --request GET \
  --url https://api.signa.so/v1/trademarks/{id}/proceedings \
  --header 'Authorization: Bearer <token>'

{
  "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 },
  "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

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 },
  "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_YOUR_KEY_HERE"

Errors

Status	Type	Description
400	`validation_error`	Invalid query parameter or trademark ID
401	`unauthorized`	Missing or invalid API key
404	`not_found`	Trademark not found
429	`rate_limited`	Too many requests

List Proceedings — search proceedings across all marks
Get Proceeding — full detail for a single proceeding
Get Trademark — parent trademark detail

Related Trademarks Trademark Coverage

Documentation Index

​Overview

​Path Parameters

​Query Parameters

​Response

​Code Examples

​Errors

​Related Endpoints

Overview

Path Parameters

Query Parameters

Response

Code Examples

Errors

Related Endpoints