---
title: "Get Ptab Trial By Number"
method: GET
path: "/ptab-trials/{ptab_trial_number}"
tags: ["PTAB Trials"]
---

# Get Ptab Trial By Number

`GET /ptab-trials/{ptab_trial_number}`

## Request

- Base URL: `https://api.lexmachina.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.lexmachina.com/ptab-trials/{ptab_trial_number}`
- Auth: HTTP bearer

Gets data for a single PTAB trial via the trial number.

- **ptab_trial_number**: a PTAB Trial number in the format TTTYYYY-NNNNN where

    TTT is one of IPR, CBM, or PGR

    YYYY is a four digit year

    NNNNN is a five digit trial number (including leading zeros)

    Examples: IPR2013-00273, CBM2015-00182, PGR2025-00084

## Path parameters

- `ptab_trial_number` string, required

## Response `200`

Success

- PTABTrialData: A single PTAB trial and relevant metadata.
  - `ptabTrialId` integer, required
  - `ptabTrialNumber` string, required
  - `status` 'Open' | 'Terminated', required
  - `dates` PTABTrialDates, required
    - `filed` string, date, required
    - `terminated` string, date, nullable
    - `institutionDecision` string, date, nullable, required
    - `finalDecision` string, date, nullable, required
  - `usptoPatentTechnologyCenter` USPTOPatentTechnologyCenter, required
    - `number` integer, required
    - `name` string, nullable, required
  - `administrativePatentJudges` AdministrativePatentJudge[], required
    - `name` string, required
    - `administrativePatentJudgeId` integer, required
    - `details` AdministrativePatentJudgeDetail[], required
      - `stage` string, required
      - `role` string, required
  - `lawFirms` LawFirm[], required
    - `name` string, required
    - `lawFirmId` integer, required
    - `clientPartyIds` integer[], required
  - `attorneys` Attorney[], required
    - `name` string, required
    - `attorneyId` integer, required
    - `lawFirmIds` integer[], required
    - `clientsPartyIds` integer[], required
  - `parties` Party[], required
    - `name` string, required
    - `partyId` integer, required
    - `role` string, required
  - `trialType` string, required
  - `trialTags` string[], required
  - `trialResolution` string, nullable, required
  - `patent` PTABPatent, required
    - `number` string, required
    - `title` string, nullable
    - `applicationNumber` string, required
  - `claimFindings` PTABClaimFindings[], nullable, required
    - `numbers` integer[], required
    - `petition` string, nullable, required
    - `institutionDecision` string, nullable, required
    - `finalWrittenDecision` string, nullable, required
  - `petitionStageGrounds` PTABPetitionStageGround, required
    - `statutes` string[], required
    - `priorArt` PriorArt[], required
      - `priorArtType` string, required
      - `priorArtReferences` string[], required
  - `institutionDecisionGrounds` PTABDecisionGround[], nullable, required
    - `decision` string, required
    - `statute` string, required
    - `claims` integer[], required
    - `priorArt` PriorArt[], required
      - `priorArtType` string, required
      - `priorArtReferences` string[], required
  - `finalDecisionGrounds` PTABDecisionGround[], nullable, required
    - `decision` string, required
    - `statute` string, required
    - `claims` integer[], required
    - `priorArt` PriorArt[], required
      - `priorArtType` string, required
      - `priorArtReferences` string[], required

## Other responses

- `401`: Invalid or expired token
- `404`: Not found
- `422`: Error - 422

---

[API](https://skmtc.dev/lexmachina/apis/lex-machina-api.md) - [All operations](https://skmtc.dev/lexmachina/apis/lex-machina-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lexmachina/apis/lex-machina-api/revisions/9ebaec5d3551?raw)