Skip to main content
GET
/
v1
/
proceedings
/
{id}
Get Proceeding
curl --request GET \
  --url https://api.example.com/v1/proceedings/{id}
{
  "id": "prc_8nM3pQ",
  "object": "proceeding",
  "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,
  "trademark": {
    "id": "tm_abc123",
    "mark_text": "AURORA",
    "office_code": "uspto",
    "jurisdiction_code": "US",
    "status": { "primary": "pending", "stage": "published" }
  },
  "livemode": true,
  "request_id": "req_xyz"
}

​
Overview

Returns the full record for a single proceeding (opposition, cancellation, appeal, court action, etc.), including the parties, contested classes, decision outcome, and a parent trademark summary.

​
Path Parameters

​
id
string
required
Proceeding ID (prc_...).

​
Response

​
id
string
Proceeding ID (prc_...).
​
object
string
Always proceeding.
​
proceeding_type
string
Type (opposition, cancellation, appeal, etc.).
​
proceeding_number
string
Office-issued proceeding identifier.
​
status
string
Current status.
​
filed_date
string
ISO date the proceeding was initiated.
​
decision_date
string
ISO date of decision when concluded.
​
decision_outcome
string
Outcome string when decided.
​
parties
object[]
Array of parties. Each has owner_id, name, role (opponent, petitioner, respondent, intervener, other), and country_code.
​
contested_classes
integer[]
Nice classes contested in the proceeding.
​
description
string
Free-text summary, when provided.
​
trademark
object
Summary of the parent trademark (id, mark_text, office_code, jurisdiction_code, status).
{
  "id": "prc_8nM3pQ",
  "object": "proceeding",
  "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,
  "trademark": {
    "id": "tm_abc123",
    "mark_text": "AURORA",
    "office_code": "uspto",
    "jurisdiction_code": "US",
    "status": { "primary": "pending", "stage": "published" }
  },
  "livemode": true,
  "request_id": "req_xyz"
}

​
Code Examples

curl "https://api.signa.so/v1/proceedings/prc_8nM3pQ" \
  -H "Authorization: Bearer sig_live_YOUR_KEY_HERE"

​
Errors

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