Trademark Proceedings

Oppositions, cancellations, appeals, and other contested proceedings involving a trademark

GET /v1/trademarks/{id}/proceedings

cURL

curl "https://api.signa.so/v1/trademarks/tm_019f34d6-2000-7777-8888-000000000001/proceedings?proceeding_type=opposition&limit=20" \
  -H "Authorization: Bearer $SIGNA_API_KEY"

{
  "object": "list",
  "data": [
    {
      "id": "prc_019f34d6-aaaa-7777-8888-aaaaaaaaaaaa",
      "proceeding_type": "opposition",
      "proceeding_number": "91265432",
      "status": "decided_granted",
      "outcome": "challenger_won",
      "duration_days": 231,
      "filed_date": "2024-01-18",
      "decision_date": "2024-09-05",
      "decision_outcome": "Opposition Sustained",
      "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"
        }
      ],
      "contested_classes": [9, 42],
      "description": "Opposition proceeding"
    }
  ],
  "has_more": false,
  "pagination": { "cursor": null },
  "request_id": "req_abc"
}

When To Use This

Use this endpoint when you are reviewing one trademark and need the dispute history attached to that mark. For example, a portfolio analyst can open a high-value mark and see every opposition or cancellation, who was involved, whether the challenger won, and how long decided cases took.

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

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

Office-issued proceeding identifier when available.

data[].status · string | null

Current status, when available.

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

data[].duration_days · integer | null

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

data[].filed_date · string | null

ISO date the proceeding was initiated, when available.

data[].decision_date · string | null

ISO date of the decision when concluded, when available.

data[].decision_outcome · string | null

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

Nice classes contested in the proceeding, when known.

data[].description · string | null

Free-text summary, when provided by the office.

Example Request

cURL

curl "https://api.signa.so/v1/trademarks/tm_019f34d6-2000-7777-8888-000000000001/proceedings?proceeding_type=opposition&limit=20" \
  -H "Authorization: Bearer $SIGNA_API_KEY"

Example Response

{
  "object": "list",
  "data": [
    {
      "id": "prc_019f34d6-aaaa-7777-8888-aaaaaaaaaaaa",
      "proceeding_type": "opposition",
      "proceeding_number": "91265432",
      "status": "decided_granted",
      "outcome": "challenger_won",
      "duration_days": 231,
      "filed_date": "2024-01-18",
      "decision_date": "2024-09-05",
      "decision_outcome": "Opposition Sustained",
      "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"
        }
      ],
      "contested_classes": [9, 42],
      "description": "Opposition proceeding"
    }
  ],
  "has_more": false,
  "pagination": { "cursor": null },
  "request_id": "req_abc"
}

Code Examples

cURL

curl "https://api.signa.so/v1/trademarks/tm_019f34d6-2000-7777-8888-000000000001/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

Related Endpoints

• List Proceedings: search proceedings across all marks
• Get Proceeding: full detail for a single proceeding
• Get Trademark: parent trademark detail
• Opposition & Dispute Intelligence: workflow for profiling an opposer