`ptab_search_decisions`

Pack: uspto-ptab · Endpoint: https://gateway.pipeworx.io/uspto-ptab/mcp

Search USPTO PTAB decision documents — institution decisions and final written decisions issued in IPR/PGR/CBM trials, plus appeal outcomes. Returns the trial number, decision type, issue date, trial/appeal outcome, the issue types and statutes/rules at play, and the decision document title + download URI. Filter by free-text query, patent_number, trial_type, and a decided_after/decided_before date range. Powered by the USPTO Open Data Portal (data.uspto.gov).

Parameters

Name	Type	Required	Description
`query`	string	no	Optional free-text keyword search across decision records.
`patent_number`	string	no	Optional. Challenged patent number, e.g. “12018298”. Matches patentOwnerData.patentNumber.
`trial_type`	string	no	Optional. Trial type code: IPR, PGR, CBM, DER. Matches trialMetaData.trialTypeCode.
`decided_after`	string	no	Optional. Only decisions on/after this date (ISO YYYY-MM-DD). Matches trialMetaData.latestDecisionDate.
`decided_before`	string	no	Optional. Only decisions on/before this date (ISO YYYY-MM-DD). Matches trialMetaData.latestDecisionDate.
`limit`	number	no	Number of results (1-100, default 10).
`offset`	number	no	Pagination offset (default 0).
`_apiKey`	string	no	USPTO ODP API key (same key as the patents pack). Get free at https://data.uspto.gov/apis/getting-started.

Example call

Arguments

{
  "patent_number": "12018298",
  "trial_type": "IPR",
  "decided_after": "2023-01-01",
  "_apiKey": "your-uspto-ptab-api-key"
}

curl

curl -X POST https://gateway.pipeworx.io/uspto-ptab/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ptab_search_decisions","arguments":{"patent_number":"12018298","trial_type":"IPR","decided_after":"2023-01-01","_apiKey":"your-uspto-ptab-api-key"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('ptab_search_decisions', {
  "patent_number": "12018298",
  "trial_type": "IPR",
  "decided_after": "2023-01-01",
  "_apiKey": "your-uspto-ptab-api-key"
});

More examples

{
  "query": "final written decision",
  "decided_before": "2024-12-31",
  "limit": 15,
  "_apiKey": "your-uspto-ptab-api-key"
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "uspto-ptab": {
      "url": "https://gateway.pipeworx.io/uspto-ptab/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

ptab_search_decisions