---
title: "Find Appeals Case By Number"
method: GET
path: "/find-appeals-cases"
tags: ["Federal Appeals Cases", "Find"]
---

# Find Appeals Case By Number

`GET /find-appeals-cases`

## 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/find-appeals-cases`
- Auth: HTTP bearer

Finds Lex Machina case ids for specified federal court of appeals case numbers.

- **case_numbers**: case number search strings
- **court**: optional court to limit results

Matches results for each individual case number is cut off at 1000 match results.

Because case number formats vary, and because the case number for the same case can change over time, the search tries to err on the side of being more inclusive.
So, this may return more results than you expect.

The court param is optional and can be any of the name versions given by the /list-courts endpoint (must match capitalization).
Providing a value for the court param will filter all case number searches in the request for cases within that court.

## Query parameters

- `caseNumbers` string[], required
- `court` string, nullable

## Response `200`

Successful Response

- AppealsCaseNumberSearchResult[]
  - `totalCount` integer, required
  - `inputCaseNumber` string, required
  - `inputCourt` string, nullable
  - `matches` AppealsCaseNumberReference[], required
    - `url` string, required
    - `appealsCaseId` integer, required
    - `civilActionNumber` string, required
    - `court` string, required
    - `title` string, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-04** `9ebaec5d3551`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/lexmachina/apis/lex-machina-api/changes/find-appeals-cases/get.md)

---

[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)