Get Proceeding

Retrieve a single trademark proceeding with parties, classes, and decision metadata

GET /v1/proceedings/{id}

cURL

curl "https://api.signa.so/v1/proceedings/prc_019f34d6-aaaa-7777-8888-aaaaaaaaaaaa" \
  -H "Authorization: Bearer $SIGNA_API_KEY"

{
  "id": "prc_019f34d6-aaaa-7777-8888-aaaaaaaaaaaa",
  "object": "proceeding",
  "trademark_id": "tm_019f34d6-2000-7777-8888-000000000001",
  "proceeding_type": "opposition",
  "proceeding_number": "91265432",
  "status": "decided_granted",
  "outcome": "challenger_won",
  "duration_days": 231,
  "office_code": "US",
  "filed_date": "2024-01-18",
  "decision_date": "2024-09-05",
  "decision_outcome": "Opposition Sustained",
  "contested_classes": [9, 42],
  "description": "Opposition proceeding",
  "created_at": "2024-01-18T10:00:00.000Z",
  "updated_at": "2024-09-05T10:00:00.000Z",
  "parties": [
    {
      "owner_id": "own_019f34d6-1111-7777-8888-111111111111",
      "name": "Apex Outdoor Group LLC",
      "role": "opponent",
      "country_code": "US"
    },
    {
      "owner_id": "own_019f34d6-2222-7777-8888-222222222222",
      "name": "Meridian Labs Inc.",
      "role": "respondent",
      "country_code": "US"
    }
  ],
  "trademark": {
    "id": "tm_019f34d6-2000-7777-8888-000000000001",
    "object": "trademark",
    "mark_text": "MERIDIAN CORE",
    "serial_number": "98123456",
    "office_code": "US"
  },
  "request_id": "req_xyz"
}

When To Use This

Use this endpoint when you already have a proceeding ID and need the full dispute record for docket review, risk analysis, or client reporting. For example, an IP litigation team can fetch a decided TTAB opposition to see the parties, contested classes, office decision summary, normalized outcome, and how long the case ran.

For an end-to-end workflow, see Opposition & Dispute Intelligence.

Path Parameters

id · string · required

Proceeding ID (prc_...).

Response

id · string

Proceeding ID (prc_...).

object · string

Always proceeding.

trademark_id · string | null

Parent trademark ID (tm_...), when available.

proceeding_type · string

Type (opposition, cancellation, appeal, etc.).

proceeding_number · string | null

Office-issued proceeding identifier, when available.

status · string | null

Current status, when available.

outcome · string | null

Normalized outcome from the challenger perspective, or null when not available.

Value	Meaning
challenger_won	The challenger prevailed, derived from decided_granted.
challenger_lost	The challenger did not prevail, derived from decided_rejected.
mixed	The decision was partial or text indicates an in-part disposition.
settled	The proceeding status is settled.
withdrawn	The proceeding status is withdrawn.
default_judgment	The challenger won through a default or procedural failure signal.
pending	The proceeding is still pending or suspended.
other	The status is other or does not map to a more specific outcome.

duration_days · integer | null

Number of days between filed_date and decision_date. null when either date is missing.

office_code · string | null

Uppercase WIPO ST.3 office code for the parent trademark (e.g. US, EM), when available.

filed_date · string | null

ISO date the proceeding was initiated, when available.

decision_date · string | null

ISO date of decision when concluded, when available.

decision_outcome · string | null

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

Nice classes contested in the proceeding, when known.

description · string | null

Free-text summary, when provided.

trademark · object | null

Summary of the parent trademark (id, object, mark_text, serial_number, office_code), or null when unavailable.

created_at · string

ISO timestamp for when Signa created the proceeding record.

updated_at · string

ISO timestamp for the latest Signa update to the proceeding record.

Example Request

cURL

curl "https://api.signa.so/v1/proceedings/prc_019f34d6-aaaa-7777-8888-aaaaaaaaaaaa" \
  -H "Authorization: Bearer $SIGNA_API_KEY"

Example Response

{
  "id": "prc_019f34d6-aaaa-7777-8888-aaaaaaaaaaaa",
  "object": "proceeding",
  "trademark_id": "tm_019f34d6-2000-7777-8888-000000000001",
  "proceeding_type": "opposition",
  "proceeding_number": "91265432",
  "status": "decided_granted",
  "outcome": "challenger_won",
  "duration_days": 231,
  "office_code": "US",
  "filed_date": "2024-01-18",
  "decision_date": "2024-09-05",
  "decision_outcome": "Opposition Sustained",
  "contested_classes": [9, 42],
  "description": "Opposition proceeding",
  "created_at": "2024-01-18T10:00:00.000Z",
  "updated_at": "2024-09-05T10:00:00.000Z",
  "parties": [
    {
      "owner_id": "own_019f34d6-1111-7777-8888-111111111111",
      "name": "Apex Outdoor Group LLC",
      "role": "opponent",
      "country_code": "US"
    },
    {
      "owner_id": "own_019f34d6-2222-7777-8888-222222222222",
      "name": "Meridian Labs Inc.",
      "role": "respondent",
      "country_code": "US"
    }
  ],
  "trademark": {
    "id": "tm_019f34d6-2000-7777-8888-000000000001",
    "object": "trademark",
    "mark_text": "MERIDIAN CORE",
    "serial_number": "98123456",
    "office_code": "US"
  },
  "request_id": "req_xyz"
}

Code Examples

cURL

curl "https://api.signa.so/v1/proceedings/prc_019f34d6-aaaa-7777-8888-aaaaaaaaaaaa" \
  -H "Authorization: Bearer sig_YOUR_KEY_HERE"

Errors

Status	Type	Description
400	validation_error	Invalid proceeding ID
401	unauthorized	Missing or invalid API key
404	not_found	Proceeding not found
429	rate_limited	Too many requests

Related Endpoints

• List Proceedings: search proceedings with filters
• Trademark Proceedings: proceedings scoped to a mark
• Opposition & Dispute Intelligence: workflow for profiling an opposer