---
title: "One PTAB proceeding by trial number, with its decisions"
method: GET
path: "/v1/ptab/{trial_number}"
tags: ["patent status"]
---

# One PTAB proceeding by trial number, with its decisions

`GET /v1/ptab/{trial_number}`

## Request

- Base URL: `https://api.patentdata.ai`
- URL: `https://api.patentdata.ai/v1/ptab/{trial_number}`
- Auth: one of:
  - API key in header `X-API-KEY`
  - HTTP bearer

Answers: what happened in IPR2026-00047 — the proceeding's parties, dates and status, the folded `instituted` / `claims_outcome` / `final_decision_date`, and its `decisions` list (same shape as /v1/patents/{n}/ptab). Pass include_text=true for the full text of each decision.

## Path parameters

- `trial_number` string, required: PTAB trial number: IPR2026-00047, PGR2026-00074, CBM..., DER... (case and spaces ignored).

## Query parameters

- `include_text` boolean: Include the full text of each decision.

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/patentdata/apis/patent-status-api.md) · [All operations](https://skmtc.dev/patentdata/apis/patent-status-api/llms.txt) · [OpenAPI document](https://skmtc.dev/patentdata/apis/patent-status-api/revisions/320133a82b42?raw)