TTAB Opposition Tracker

Track TTAB trademark opposition and cancellation proceedings from the USPTO's public TTABVUE system. Built for IP counsel, brand teams, researchers and AI agents.

This actor surfaces public IP records as data for your attorney or IP team — it is not legal advice or a legal clearance opinion.

Input

Give a party name or a list of proceedingNumbers. An empty input returns 0 rows with a message naming the field and is not charged.

{
  "party": "Nike",
  "maxResults": 50,
  "includeExtensions": true
}

Pull specific proceedings instead of searching:

{
  "proceedingNumbers": ["91308128", "92091953"]
}

Field	Type	Default	Meaning
party	string	—	Search proceedings involving this party (plaintiff, defendant or potential opposer). Required unless proceedingNumbers is set.
proceedingNumbers	string[]	—	Specific TTAB proceeding numbers. Overrides party. Numbers not found are reported, not charged.
proceedingType	enum	all	opposition, cancellation, concurrent use, interference or all.
status	enum	all	pending, terminated or all.
includeExtensions	boolean	true	Include Extension-of-Time-to-Oppose filings (see below). Set false to exclude them.
maxResults	integer	50	1–500. Upper bound on delivered (and billed) proceedings.
detailLevel	enum	full	full reads each proceeding's page (status, status date, all parties; ~1 s each). summary returns the search-page fields (number, type, filing date, plaintiff, defendant, mark numbers) for hundreds of proceedings in seconds. Every row carries a detailLevel field. In full mode, a proceeding whose page cannot be read in time is delivered as a summary row rather than dropped.

How the party search paginates

TTABVUE returns 25 proceedings per result page. The actor reads page 1, then follows the page=2..N links until maxResults proceedings are collected or the last page is reached (at most ceil(maxResults / 25) pages). The run status message reports "found N" and says "(capped at maxResults=…)" when more results exist than were fetched — raise maxResults to fetch more. If a result page comes back as neither results nor TTABVUE's verified "is not found" marker, the run fails loudly instead of returning a short, silent list.

Extension-of-Time filings (numbered by the trademark application serial, e.g. 98xxxxxx)

TTABVUE lists "Extension of Time to Oppose" requests alongside inter-partes proceedings. They are not oppositions or cancellations: they are requests to extend the deadline to file an opposition against a pending application. The actor emits them with proceedingType: "Extension of Time to Oppose", the requesting party ("Potential Opposer") as plaintiff, and the applicant as defendant. They are included by default (and billed like any other record); pass includeExtensions: false to leave them out — the status message then reports how many were excluded.

Re-running

There is no watch or monitoring mode. Re-run the actor (manually or on an Apify schedule) to refresh; every returned proceeding is billed on every run.

What you get

Clean JSON, one record per proceeding — 13 fields:

• proceedingNumber — TTAB proceeding number
• proceedingType — Opposition, Cancellation, Concurrent Use, Interference, Ex Parte Appeal, Extension of Time to Oppose, or Other
• filingDate — filing date (ISO YYYY-MM-DD)
• status — current status text, e.g. "Pending", "Terminated", "Extension of Time to Oppose Filed"
• statusDate — date of the current status (ISO)
• plaintiff — first listed plaintiff (potential opposer for Extension-of-Time filings)
• allPlaintiffs — all listed plaintiffs
• defendant — first listed defendant
• allDefendants — all listed defendants
• markSerialNumbers — application serial numbers at issue
• markRegistrationNumbers — registration numbers at issue
• ttabvueUrl — link to the TTABVUE proceeding page
• dataSource — USPTO TTABVUE (live)

Pricing

$0.10 per delivered proceeding + $0.005 per run start (Pay-Per-Event) — about 10 proceedings per $1. Records are pushed one at a time as each detail page is parsed, so a run stopped by its time limit still delivers and bills only what was completed; the status message then says "stopped at time budget: delivered X of N found". If no proceeding can be retrieved, the run fails and nothing beyond the start fee is charged.

Use with AI agents

Point Claude, the OpenAI Agents SDK, an n8n flow or any MCP-aware client at it and pull TTAB proceedings on demand.

Sample agent prompt:

List the TTAB opposition proceedings involving Nike filed this year.

Related IP actors

Clear a mark across every major registry: USPTO Trademarks, EUIPO Trademarks, WIPO PatentScope, CNIPA China, Korea KIPO

IP agent front door: Patents & Trademarks IP MCP

---

Data from the public USPTO TTABVUE registry.

UK clearance → uk-trademark-search.