---
name: orthogonal-courtlistener
description: "Call CourtListener through Orthogonal's pay-per-use Run API: Free Law Project's CourtListener REST API v4: search US case law, opinions, PACER/RECAP dockets and filings, courts, judges, financial disclosures and oral argument audio, plus citation lookup to verify legal citations."
---

# CourtListener — Orthogonal API

> Pay-per-use API on Orthogonal. Each call is billed to your Orthogonal balance.
> Base API: `https://api.orthogonal.com/v1/run` · [llms.txt](https://www.orthogonal.com/llms.txt) · [browse all APIs](https://www.orthogonal.com/catalog)

Free Law Project's CourtListener REST API v4: search US case law, opinions, PACER/RECAP dockets and filings, courts, judges, financial disclosures and oral argument audio, plus citation lookup to verify legal citations.

**Verified:** no

## Access

**Run API:** `POST https://api.orthogonal.com/v1/run`
**Auth:** `Authorization: Bearer $ORTHOGONAL_API_KEY`
Get an API key at https://www.orthogonal.com/account/keys

No account or key yet? Set up Orthogonal first with https://www.orthogonal.com/skill.md: it covers the CLI, the MCP server, the TypeScript SDK and sign-up, including an agent sign-up without a password (https://www.orthogonal.com/agent-signup.md).

Every call goes through the unified Run API: send the API `slug`, the endpoint `path`, and the `query`/`body` parameters. The response is `{ "success": true, "priceCents": <US cents>, "requestId": "...", "data": { ... } }`.

Quote first, free: the same request with `"dryRun": true` returns the price without calling the API or charging anything. On a retry after a timeout, send the same `Idempotency-Key` header so the call runs and bills once.

## Endpoints

### Court list

Lists the courts and jurisdictions CourtListener covers, with their IDs (e.g. scotus, dcd).

`GET /courts/`

**Estimated cost:** $0.00218

**Page:** https://www.orthogonal.com/api/courtlistener/c39bcc42-0be6-4440-8b11-da3fe06bf2f7

**Docs:** https://wiki.free.law/c/courtlistener/help/api/rest/v4/case-law

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `fields` | string | No | Comma-separated fields to return; double underscores select nested fields. |
| `omit` | string | No | Comma-separated fields to leave out of the response. |
| `order_by` | string | No | Field to order by (see the endpoint's OPTIONS ordering list); prefix with - for descending, comma-separate tie-breakers. |
| `page` | integer | No | Page number (limited to 100 pages); not used when ordering by id, date_created or date_modified. |
| `cursor` | string | No | Cursor from a previous response's next/previous URL for deep pagination. |
| `count` | string | No | Set to on to return only the total count of matching items. |
| `id` | integer | No | Filter by ID; supports lookups such as id__gt, id__lt, id__range. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"courtlistener","path":"/courts/","method":"GET","query":{"fields":"<string>","omit":"<string>","order_by":"<string>","page":"<integer>","cursor":"<string>","count":"<string>","id":"<integer>"}}'
```

### Court details

One court by its ID, such as scotus or dcd.

`GET /courts/{id}/`

**Estimated cost:** $0.00218

**Page:** https://www.orthogonal.com/api/courtlistener/cf208d11-b42f-4c21-b664-47dc7652dc94

**Docs:** https://wiki.free.law/c/courtlistener/help/api/rest/v4/case-law

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `fields` | string | No | Comma-separated fields to return; double underscores select nested fields. |
| `omit` | string | No | Comma-separated fields to leave out of the response. |

```bash
# Replace {id} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"courtlistener","path":"/courts/{id}/","method":"GET","query":{"fields":"<string>","omit":"<string>"}}'
```

### Case cluster list

Lists opinion clusters: a case decision grouping its opinions, with case name, citations, judges and dates. Filter by docket fields.

`GET /clusters/`

**Estimated cost:** $0.00218

**Page:** https://www.orthogonal.com/api/courtlistener/b31415b0-d8f0-4cc9-a789-f4e47c817812

**Docs:** https://wiki.free.law/c/courtlistener/help/api/rest/v4/case-law

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `fields` | string | No | Comma-separated fields to return; double underscores select nested fields. |
| `omit` | string | No | Comma-separated fields to leave out of the response. |
| `order_by` | string | No | Field to order by (see the endpoint's OPTIONS ordering list); prefix with - for descending, comma-separate tie-breakers. |
| `page` | integer | No | Page number (limited to 100 pages); not used when ordering by id, date_created or date_modified. |
| `cursor` | string | No | Cursor from a previous response's next/previous URL for deep pagination. |
| `count` | string | No | Set to on to return only the total count of matching items. |
| `id` | integer | No | Filter by ID; supports lookups such as id__gt, id__lt, id__range. |
| `docket__docket_number` | string | No | Filter by docket number. |
| `docket__court` | string | No | Filter by court ID. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"courtlistener","path":"/clusters/","method":"GET","query":{"fields":"<string>","omit":"<string>","order_by":"<string>","page":"<integer>","cursor":"<string>","count":"<string>","id":"<integer>","docket__docket_number":"<string>","docket__court":"<string>"}}'
```

### Case cluster details

One opinion cluster (a decided case) by its ID; the ID is the one used in CourtListener opinion URLs.

`GET /clusters/{id}/`

**Estimated cost:** $0.00218

**Page:** https://www.orthogonal.com/api/courtlistener/fe43c146-1c99-4444-9a9f-a36b3ae8d45f

**Docs:** https://wiki.free.law/c/courtlistener/help/api/rest/v4/case-law

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `fields` | string | No | Comma-separated fields to return; double underscores select nested fields. |
| `omit` | string | No | Comma-separated fields to leave out of the response. |

```bash
# Replace {id} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"courtlistener","path":"/clusters/{id}/","method":"GET","query":{"fields":"<string>","omit":"<string>"}}'
```

### Opinion list

Lists court opinions with their full text and metadata. Filter by court or docket number through the cluster.

`GET /opinions/`

**Estimated cost:** $0.00218

**Page:** https://www.orthogonal.com/api/courtlistener/f10bd061-0a33-4f02-8ae2-dbdef144db9c

**Docs:** https://wiki.free.law/c/courtlistener/help/api/rest/v4/case-law

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `fields` | string | No | Comma-separated fields to return; double underscores select nested fields. |
| `omit` | string | No | Comma-separated fields to leave out of the response. |
| `order_by` | string | No | Field to order by (see the endpoint's OPTIONS ordering list); prefix with - for descending, comma-separate tie-breakers. |
| `page` | integer | No | Page number (limited to 100 pages); not used when ordering by id, date_created or date_modified. |
| `cursor` | string | No | Cursor from a previous response's next/previous URL for deep pagination. |
| `count` | string | No | Set to on to return only the total count of matching items. |
| `id` | integer | No | Filter by ID; supports lookups such as id__gt, id__lt, id__range. |
| `cluster__docket__court` | string | No | Filter opinions to one court ID. |
| `cluster__docket__docket_number` | string | No | Filter by docket number. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"courtlistener","path":"/opinions/","method":"GET","query":{"fields":"<string>","omit":"<string>","order_by":"<string>","page":"<integer>","cursor":"<string>","count":"<string>","id":"<integer>","cluster__docket__court":"<string>","cluster__docket__docket_number":"<string>"}}'
```

### Opinion details

One court opinion, with its text, by opinion ID (opinion IDs do not match cluster IDs).

`GET /opinions/{id}/`

**Estimated cost:** $0.00218

**Page:** https://www.orthogonal.com/api/courtlistener/6b2b5a85-ba92-49ef-ad20-0f98740db245

**Docs:** https://wiki.free.law/c/courtlistener/help/api/rest/v4/case-law

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `fields` | string | No | Comma-separated fields to return; double underscores select nested fields. |
| `omit` | string | No | Comma-separated fields to leave out of the response. |

```bash
# Replace {id} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"courtlistener","path":"/opinions/{id}/","method":"GET","query":{"fields":"<string>","omit":"<string>"}}'
```

### Citation graph

Which opinions cite which: filter by citing_opinion to see what an opinion cites, or cited_opinion to see what cites it.

`GET /opinions-cited/`

**Estimated cost:** $0.00218

**Page:** https://www.orthogonal.com/api/courtlistener/1c8285e8-5b39-4af8-8816-e3313bb0ae02

**Docs:** https://wiki.free.law/c/courtlistener/help/api/rest/v4/citations

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `fields` | string | No | Comma-separated fields to return; double underscores select nested fields. |
| `omit` | string | No | Comma-separated fields to leave out of the response. |
| `order_by` | string | No | Field to order by (see the endpoint's OPTIONS ordering list); prefix with - for descending, comma-separate tie-breakers. |
| `page` | integer | No | Page number (limited to 100 pages); not used when ordering by id, date_created or date_modified. |
| `cursor` | string | No | Cursor from a previous response's next/previous URL for deep pagination. |
| `count` | string | No | Set to on to return only the total count of matching items. |
| `id` | integer | No | Filter by ID; supports lookups such as id__gt, id__lt, id__range. |
| `citing_opinion` | integer | No | ID of the opinion doing the citing. |
| `cited_opinion` | integer | No | ID of the opinion being cited. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"courtlistener","path":"/opinions-cited/","method":"GET","query":{"fields":"<string>","omit":"<string>","order_by":"<string>","page":"<integer>","cursor":"<string>","count":"<string>","id":"<integer>","citing_opinion":"<integer>","cited_opinion":"<integer>"}}'
```

### Docket list

Lists dockets (cases) from PACER, oral arguments and case law, with court, docket number, parties' case name and dates.

`GET /dockets/`

**Estimated cost:** $0.00218

**Page:** https://www.orthogonal.com/api/courtlistener/a6af8014-c10d-4b94-b48c-4f4bd40fedee

**Docs:** https://wiki.free.law/c/courtlistener/help/api/rest/v4/pacer-data

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `fields` | string | No | Comma-separated fields to return; double underscores select nested fields. |
| `omit` | string | No | Comma-separated fields to leave out of the response. |
| `order_by` | string | No | Field to order by (see the endpoint's OPTIONS ordering list); prefix with - for descending, comma-separate tie-breakers. |
| `page` | integer | No | Page number (limited to 100 pages); not used when ordering by id, date_created or date_modified. |
| `cursor` | string | No | Cursor from a previous response's next/previous URL for deep pagination. |
| `count` | string | No | Set to on to return only the total count of matching items. |
| `id` | integer | No | Filter by ID; supports lookups such as id__gt, id__lt, id__range. |
| `court` | string | No | Filter by court ID. |
| `docket_number` | string | No | Filter by docket number. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"courtlistener","path":"/dockets/","method":"GET","query":{"fields":"<string>","omit":"<string>","order_by":"<string>","page":"<integer>","cursor":"<string>","count":"<string>","id":"<integer>","court":"<string>","docket_number":"<string>"}}'
```

### Docket details

One docket (case) by its ID.

`GET /dockets/{id}/`

**Estimated cost:** $0.00218

**Page:** https://www.orthogonal.com/api/courtlistener/308eab31-6474-400c-b52a-1ce8aae4e4b5

**Docs:** https://wiki.free.law/c/courtlistener/help/api/rest/v4/pacer-data

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `fields` | string | No | Comma-separated fields to return; double underscores select nested fields. |
| `omit` | string | No | Comma-separated fields to leave out of the response. |

```bash
# Replace {id} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"courtlistener","path":"/dockets/{id}/","method":"GET","query":{"fields":"<string>","omit":"<string>"}}'
```

### Docket entry list

Lists the entries of PACER dockets, with their nested RECAP documents. Filter by docket.

`GET /docket-entries/`

**Estimated cost:** $0.00218

**Page:** https://www.orthogonal.com/api/courtlistener/cb33c206-34c9-48d3-bc29-1849c2b58c71

**Docs:** https://wiki.free.law/c/courtlistener/help/api/rest/v4/pacer-data

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `fields` | string | No | Comma-separated fields to return; double underscores select nested fields. |
| `omit` | string | No | Comma-separated fields to leave out of the response. |
| `order_by` | string | No | Field to order by (see the endpoint's OPTIONS ordering list); prefix with - for descending, comma-separate tie-breakers. |
| `page` | integer | No | Page number (limited to 100 pages); not used when ordering by id, date_created or date_modified. |
| `cursor` | string | No | Cursor from a previous response's next/previous URL for deep pagination. |
| `count` | string | No | Set to on to return only the total count of matching items. |
| `id` | integer | No | Filter by ID; supports lookups such as id__gt, id__lt, id__range. |
| `docket` | integer | No | Docket ID whose entries to list. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"courtlistener","path":"/docket-entries/","method":"GET","query":{"fields":"<string>","omit":"<string>","order_by":"<string>","page":"<integer>","cursor":"<string>","count":"<string>","id":"<integer>","docket":"<integer>"}}'
```

### Court filing list

Lists PACER filing documents in the RECAP archive, with their metadata and extracted text where available.

`GET /recap-documents/`

**Estimated cost:** $0.00218

**Page:** https://www.orthogonal.com/api/courtlistener/7c88444b-d3a1-4c93-b7df-b8c4d76757ee

**Docs:** https://wiki.free.law/c/courtlistener/help/api/rest/v4/pacer-data

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `fields` | string | No | Comma-separated fields to return; double underscores select nested fields. |
| `omit` | string | No | Comma-separated fields to leave out of the response. |
| `order_by` | string | No | Field to order by (see the endpoint's OPTIONS ordering list); prefix with - for descending, comma-separate tie-breakers. |
| `page` | integer | No | Page number (limited to 100 pages); not used when ordering by id, date_created or date_modified. |
| `cursor` | string | No | Cursor from a previous response's next/previous URL for deep pagination. |
| `count` | string | No | Set to on to return only the total count of matching items. |
| `id` | integer | No | Filter by ID; supports lookups such as id__gt, id__lt, id__range. |
| `docket_entry__docket` | integer | No | Filter by docket ID through the docket entry. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"courtlistener","path":"/recap-documents/","method":"GET","query":{"fields":"<string>","omit":"<string>","order_by":"<string>","page":"<integer>","cursor":"<string>","count":"<string>","id":"<integer>","docket_entry__docket":"<integer>"}}'
```

### Party list

Lists parties to PACER cases, with their attorneys and roles. Filter by docket.

`GET /parties/`

**Estimated cost:** $0.00218

**Page:** https://www.orthogonal.com/api/courtlistener/44531f46-434e-4913-9554-3e4f75857b92

**Docs:** https://wiki.free.law/c/courtlistener/help/api/rest/v4/pacer-data

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `fields` | string | No | Comma-separated fields to return; double underscores select nested fields. |
| `omit` | string | No | Comma-separated fields to leave out of the response. |
| `order_by` | string | No | Field to order by (see the endpoint's OPTIONS ordering list); prefix with - for descending, comma-separate tie-breakers. |
| `page` | integer | No | Page number (limited to 100 pages); not used when ordering by id, date_created or date_modified. |
| `cursor` | string | No | Cursor from a previous response's next/previous URL for deep pagination. |
| `count` | string | No | Set to on to return only the total count of matching items. |
| `id` | integer | No | Filter by ID; supports lookups such as id__gt, id__lt, id__range. |
| `docket` | integer | No | Docket ID. |
| `filter_nested_results` | boolean | No | Set True to limit nested attorney data to the filtered docket. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"courtlistener","path":"/parties/","method":"GET","query":{"fields":"<string>","omit":"<string>","order_by":"<string>","page":"<integer>","cursor":"<string>","count":"<string>","id":"<integer>","docket":"<integer>","filter_nested_results":"<boolean>"}}'
```

### Attorney list

Lists attorneys in PACER cases, with the parties they represent. Filter by docket.

`GET /attorneys/`

**Estimated cost:** $0.00218

**Page:** https://www.orthogonal.com/api/courtlistener/88a2458a-bff2-4390-a2e7-800abeb42936

**Docs:** https://wiki.free.law/c/courtlistener/help/api/rest/v4/pacer-data

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `fields` | string | No | Comma-separated fields to return; double underscores select nested fields. |
| `omit` | string | No | Comma-separated fields to leave out of the response. |
| `order_by` | string | No | Field to order by (see the endpoint's OPTIONS ordering list); prefix with - for descending, comma-separate tie-breakers. |
| `page` | integer | No | Page number (limited to 100 pages); not used when ordering by id, date_created or date_modified. |
| `cursor` | string | No | Cursor from a previous response's next/previous URL for deep pagination. |
| `count` | string | No | Set to on to return only the total count of matching items. |
| `id` | integer | No | Filter by ID; supports lookups such as id__gt, id__lt, id__range. |
| `docket` | integer | No | Docket ID. |
| `filter_nested_results` | boolean | No | Set True to limit nested party data to the filtered docket. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"courtlistener","path":"/attorneys/","method":"GET","query":{"fields":"<string>","omit":"<string>","order_by":"<string>","page":"<integer>","cursor":"<string>","count":"<string>","id":"<integer>","docket":"<integer>","filter_nested_results":"<boolean>"}}'
```

### Originating court info

Lists lower-court information for appellate dockets (originating court, judges, dates).

`GET /originating-court-information/`

**Estimated cost:** $0.00218

**Page:** https://www.orthogonal.com/api/courtlistener/97706f30-5014-4bad-b8f8-08f32e6c415c

**Docs:** https://wiki.free.law/c/courtlistener/help/api/rest/v4/pacer-data

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `fields` | string | No | Comma-separated fields to return; double underscores select nested fields. |
| `omit` | string | No | Comma-separated fields to leave out of the response. |
| `order_by` | string | No | Field to order by (see the endpoint's OPTIONS ordering list); prefix with - for descending, comma-separate tie-breakers. |
| `page` | integer | No | Page number (limited to 100 pages); not used when ordering by id, date_created or date_modified. |
| `cursor` | string | No | Cursor from a previous response's next/previous URL for deep pagination. |
| `count` | string | No | Set to on to return only the total count of matching items. |
| `id` | integer | No | Filter by ID; supports lookups such as id__gt, id__lt, id__range. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"courtlistener","path":"/originating-court-information/","method":"GET","query":{"fields":"<string>","omit":"<string>","order_by":"<string>","page":"<integer>","cursor":"<string>","count":"<string>","id":"<integer>"}}'
```

### Bankruptcy info

Lists bankruptcy-specific details for bankruptcy dockets.

`GET /bankruptcy-information/`

**Estimated cost:** $0.00218

**Page:** https://www.orthogonal.com/api/courtlistener/f82de98a-e0ae-488f-a123-9776648ca36e

**Docs:** https://wiki.free.law/c/courtlistener/help/api/rest/v4/pacer-data

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `fields` | string | No | Comma-separated fields to return; double underscores select nested fields. |
| `omit` | string | No | Comma-separated fields to leave out of the response. |
| `order_by` | string | No | Field to order by (see the endpoint's OPTIONS ordering list); prefix with - for descending, comma-separate tie-breakers. |
| `page` | integer | No | Page number (limited to 100 pages); not used when ordering by id, date_created or date_modified. |
| `cursor` | string | No | Cursor from a previous response's next/previous URL for deep pagination. |
| `count` | string | No | Set to on to return only the total count of matching items. |
| `id` | integer | No | Filter by ID; supports lookups such as id__gt, id__lt, id__range. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"courtlistener","path":"/bankruptcy-information/","method":"GET","query":{"fields":"<string>","omit":"<string>","order_by":"<string>","page":"<integer>","cursor":"<string>","count":"<string>","id":"<integer>"}}'
```

### FJC case database

Lists records from the Federal Judicial Center's Integrated Database of federal cases (marked experimental by the provider).

`GET /fjc-integrated-database/`

**Estimated cost:** $0.00218

**Page:** https://www.orthogonal.com/api/courtlistener/5ec3437a-9835-49e0-9fe9-ff04b39a33d4

**Docs:** https://wiki.free.law/c/courtlistener/help/api/rest/v4/pacer-data

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `fields` | string | No | Comma-separated fields to return; double underscores select nested fields. |
| `omit` | string | No | Comma-separated fields to leave out of the response. |
| `order_by` | string | No | Field to order by (see the endpoint's OPTIONS ordering list); prefix with - for descending, comma-separate tie-breakers. |
| `page` | integer | No | Page number (limited to 100 pages); not used when ordering by id, date_created or date_modified. |
| `cursor` | string | No | Cursor from a previous response's next/previous URL for deep pagination. |
| `count` | string | No | Set to on to return only the total count of matching items. |
| `id` | integer | No | Filter by ID; supports lookups such as id__gt, id__lt, id__range. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"courtlistener","path":"/fjc-integrated-database/","method":"GET","query":{"fields":"<string>","omit":"<string>","order_by":"<string>","page":"<integer>","cursor":"<string>","count":"<string>","id":"<integer>"}}'
```

### Judge list

Lists judges and appointers with biographical data, nested positions, educations and political affiliations.

`GET /people/`

**Estimated cost:** $0.00218

**Page:** https://www.orthogonal.com/api/courtlistener/0bcb2e95-d796-4ac2-befe-e3b440476aab

**Docs:** https://wiki.free.law/c/courtlistener/help/api/rest/v4/american-judge-and-justice-api

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `fields` | string | No | Comma-separated fields to return; double underscores select nested fields. |
| `omit` | string | No | Comma-separated fields to leave out of the response. |
| `order_by` | string | No | Field to order by (see the endpoint's OPTIONS ordering list); prefix with - for descending, comma-separate tie-breakers. |
| `page` | integer | No | Page number (limited to 100 pages); not used when ordering by id, date_created or date_modified. |
| `cursor` | string | No | Cursor from a previous response's next/previous URL for deep pagination. |
| `count` | string | No | Set to on to return only the total count of matching items. |
| `id` | integer | No | Filter by ID; supports lookups such as id__gt, id__lt, id__range. |
| `educations__school__name__contains` | string | No | Filter judges by school name. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"courtlistener","path":"/people/","method":"GET","query":{"fields":"<string>","omit":"<string>","order_by":"<string>","page":"<integer>","cursor":"<string>","count":"<string>","id":"<integer>","educations__school__name__contains":"<string>"}}'
```

### Judge details

One judge or appointer by person ID.

`GET /people/{id}/`

**Estimated cost:** $0.00218

**Page:** https://www.orthogonal.com/api/courtlistener/e15716a4-236d-4aec-a787-f1dffe0de101

**Docs:** https://wiki.free.law/c/courtlistener/help/api/rest/v4/american-judge-and-justice-api

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `fields` | string | No | Comma-separated fields to return; double underscores select nested fields. |
| `omit` | string | No | Comma-separated fields to leave out of the response. |

```bash
# Replace {id} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"courtlistener","path":"/people/{id}/","method":"GET","query":{"fields":"<string>","omit":"<string>"}}'
```

### Judicial positions

Lists positions held by judges (court, appointment and nomination dates, termination). Filter by person.

`GET /positions/`

**Estimated cost:** $0.00218

**Page:** https://www.orthogonal.com/api/courtlistener/201e22d2-6cc4-46af-95ab-a69afd1e8b1f

**Docs:** https://wiki.free.law/c/courtlistener/help/api/rest/v4/american-judge-and-justice-api

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `fields` | string | No | Comma-separated fields to return; double underscores select nested fields. |
| `omit` | string | No | Comma-separated fields to leave out of the response. |
| `order_by` | string | No | Field to order by (see the endpoint's OPTIONS ordering list); prefix with - for descending, comma-separate tie-breakers. |
| `page` | integer | No | Page number (limited to 100 pages); not used when ordering by id, date_created or date_modified. |
| `cursor` | string | No | Cursor from a previous response's next/previous URL for deep pagination. |
| `count` | string | No | Set to on to return only the total count of matching items. |
| `id` | integer | No | Filter by ID; supports lookups such as id__gt, id__lt, id__range. |
| `person` | integer | No | Person (judge) ID. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"courtlistener","path":"/positions/","method":"GET","query":{"fields":"<string>","omit":"<string>","order_by":"<string>","page":"<integer>","cursor":"<string>","count":"<string>","id":"<integer>","person":"<integer>"}}'
```

### Judge political affiliations

Lists judges' political party affiliations and their sources.

`GET /political-affiliations/`

**Estimated cost:** $0.00218

**Page:** https://www.orthogonal.com/api/courtlistener/d1d199eb-988b-473f-8828-60947b673a51

**Docs:** https://wiki.free.law/c/courtlistener/help/api/rest/v4/american-judge-and-justice-api

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `fields` | string | No | Comma-separated fields to return; double underscores select nested fields. |
| `omit` | string | No | Comma-separated fields to leave out of the response. |
| `order_by` | string | No | Field to order by (see the endpoint's OPTIONS ordering list); prefix with - for descending, comma-separate tie-breakers. |
| `page` | integer | No | Page number (limited to 100 pages); not used when ordering by id, date_created or date_modified. |
| `cursor` | string | No | Cursor from a previous response's next/previous URL for deep pagination. |
| `count` | string | No | Set to on to return only the total count of matching items. |
| `id` | integer | No | Filter by ID; supports lookups such as id__gt, id__lt, id__range. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"courtlistener","path":"/political-affiliations/","method":"GET","query":{"fields":"<string>","omit":"<string>","order_by":"<string>","page":"<integer>","cursor":"<string>","count":"<string>","id":"<integer>"}}'
```

### Judge educations

Lists judges' degrees and schools.

`GET /educations/`

**Estimated cost:** $0.00218

**Page:** https://www.orthogonal.com/api/courtlistener/e9dac022-85d0-4664-871b-6699860acb8d

**Docs:** https://wiki.free.law/c/courtlistener/help/api/rest/v4/american-judge-and-justice-api

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `fields` | string | No | Comma-separated fields to return; double underscores select nested fields. |
| `omit` | string | No | Comma-separated fields to leave out of the response. |
| `order_by` | string | No | Field to order by (see the endpoint's OPTIONS ordering list); prefix with - for descending, comma-separate tie-breakers. |
| `page` | integer | No | Page number (limited to 100 pages); not used when ordering by id, date_created or date_modified. |
| `cursor` | string | No | Cursor from a previous response's next/previous URL for deep pagination. |
| `count` | string | No | Set to on to return only the total count of matching items. |
| `id` | integer | No | Filter by ID; supports lookups such as id__gt, id__lt, id__range. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"courtlistener","path":"/educations/","method":"GET","query":{"fields":"<string>","omit":"<string>","order_by":"<string>","page":"<integer>","cursor":"<string>","count":"<string>","id":"<integer>"}}'
```

### Law school list

Lists schools referenced in judges' education records (Department of Education data).

`GET /schools/`

**Estimated cost:** $0.00218

**Page:** https://www.orthogonal.com/api/courtlistener/d9ce0e4a-4768-4f8b-bef3-9e4e6a7640d4

**Docs:** https://wiki.free.law/c/courtlistener/help/api/rest/v4/american-judge-and-justice-api

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `fields` | string | No | Comma-separated fields to return; double underscores select nested fields. |
| `omit` | string | No | Comma-separated fields to leave out of the response. |
| `order_by` | string | No | Field to order by (see the endpoint's OPTIONS ordering list); prefix with - for descending, comma-separate tie-breakers. |
| `page` | integer | No | Page number (limited to 100 pages); not used when ordering by id, date_created or date_modified. |
| `cursor` | string | No | Cursor from a previous response's next/previous URL for deep pagination. |
| `count` | string | No | Set to on to return only the total count of matching items. |
| `id` | integer | No | Filter by ID; supports lookups such as id__gt, id__lt, id__range. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"courtlistener","path":"/schools/","method":"GET","query":{"fields":"<string>","omit":"<string>","order_by":"<string>","page":"<integer>","cursor":"<string>","count":"<string>","id":"<integer>"}}'
```

### Judge ABA ratings

Lists American Bar Association ratings of judicial nominees.

`GET /aba-ratings/`

**Estimated cost:** $0.00218

**Page:** https://www.orthogonal.com/api/courtlistener/5fcbd697-b679-44e6-aea1-6388ba313d5f

**Docs:** https://wiki.free.law/c/courtlistener/help/api/rest/v4/american-judge-and-justice-api

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `fields` | string | No | Comma-separated fields to return; double underscores select nested fields. |
| `omit` | string | No | Comma-separated fields to leave out of the response. |
| `order_by` | string | No | Field to order by (see the endpoint's OPTIONS ordering list); prefix with - for descending, comma-separate tie-breakers. |
| `page` | integer | No | Page number (limited to 100 pages); not used when ordering by id, date_created or date_modified. |
| `cursor` | string | No | Cursor from a previous response's next/previous URL for deep pagination. |
| `count` | string | No | Set to on to return only the total count of matching items. |
| `id` | integer | No | Filter by ID; supports lookups such as id__gt, id__lt, id__range. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"courtlistener","path":"/aba-ratings/","method":"GET","query":{"fields":"<string>","omit":"<string>","order_by":"<string>","page":"<integer>","cursor":"<string>","count":"<string>","id":"<integer>"}}'
```

### Judge retention events

Lists retention events (reappointments, retention votes) for judges' positions.

`GET /retention-events/`

**Estimated cost:** $0.00218

**Page:** https://www.orthogonal.com/api/courtlistener/8374f1f1-5915-4528-b520-9d5a8ced9fc1

**Docs:** https://wiki.free.law/c/courtlistener/help/api/rest/v4/american-judge-and-justice-api

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `fields` | string | No | Comma-separated fields to return; double underscores select nested fields. |
| `omit` | string | No | Comma-separated fields to leave out of the response. |
| `order_by` | string | No | Field to order by (see the endpoint's OPTIONS ordering list); prefix with - for descending, comma-separate tie-breakers. |
| `page` | integer | No | Page number (limited to 100 pages); not used when ordering by id, date_created or date_modified. |
| `cursor` | string | No | Cursor from a previous response's next/previous URL for deep pagination. |
| `count` | string | No | Set to on to return only the total count of matching items. |
| `id` | integer | No | Filter by ID; supports lookups such as id__gt, id__lt, id__range. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"courtlistener","path":"/retention-events/","method":"GET","query":{"fields":"<string>","omit":"<string>","order_by":"<string>","page":"<integer>","cursor":"<string>","count":"<string>","id":"<integer>"}}'
```

### Judge data sources

Lists the sources behind judge records.

`GET /sources/`

**Estimated cost:** $0.00218

**Page:** https://www.orthogonal.com/api/courtlistener/3af10413-0259-4c8b-865d-bf1ee0d01577

**Docs:** https://wiki.free.law/c/courtlistener/help/api/rest/v4/american-judge-and-justice-api

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `fields` | string | No | Comma-separated fields to return; double underscores select nested fields. |
| `omit` | string | No | Comma-separated fields to leave out of the response. |
| `order_by` | string | No | Field to order by (see the endpoint's OPTIONS ordering list); prefix with - for descending, comma-separate tie-breakers. |
| `page` | integer | No | Page number (limited to 100 pages); not used when ordering by id, date_created or date_modified. |
| `cursor` | string | No | Cursor from a previous response's next/previous URL for deep pagination. |
| `count` | string | No | Set to on to return only the total count of matching items. |
| `id` | integer | No | Filter by ID; supports lookups such as id__gt, id__lt, id__range. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"courtlistener","path":"/sources/","method":"GET","query":{"fields":"<string>","omit":"<string>","order_by":"<string>","page":"<integer>","cursor":"<string>","count":"<string>","id":"<integer>"}}'
```

### Oral argument list

Lists oral argument recordings with case name, court, duration, judges and audio file links.

`GET /audio/`

**Estimated cost:** $0.00218

**Page:** https://www.orthogonal.com/api/courtlistener/18b1025e-18c5-4b75-8cdc-ec00273e182c

**Docs:** https://wiki.free.law/c/courtlistener/help/api/rest/v4/oral-arguments

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `fields` | string | No | Comma-separated fields to return; double underscores select nested fields. |
| `omit` | string | No | Comma-separated fields to leave out of the response. |
| `order_by` | string | No | Field to order by (see the endpoint's OPTIONS ordering list); prefix with - for descending, comma-separate tie-breakers. |
| `page` | integer | No | Page number (limited to 100 pages); not used when ordering by id, date_created or date_modified. |
| `cursor` | string | No | Cursor from a previous response's next/previous URL for deep pagination. |
| `count` | string | No | Set to on to return only the total count of matching items. |
| `id` | integer | No | Filter by ID; supports lookups such as id__gt, id__lt, id__range. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"courtlistener","path":"/audio/","method":"GET","query":{"fields":"<string>","omit":"<string>","order_by":"<string>","page":"<integer>","cursor":"<string>","count":"<string>","id":"<integer>"}}'
```

### Oral argument details

One oral argument recording by ID.

`GET /audio/{id}/`

**Estimated cost:** $0.00218

**Page:** https://www.orthogonal.com/api/courtlistener/667e82fa-4aa8-486e-bf8b-ccc388981a43

**Docs:** https://wiki.free.law/c/courtlistener/help/api/rest/v4/oral-arguments

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `fields` | string | No | Comma-separated fields to return; double underscores select nested fields. |
| `omit` | string | No | Comma-separated fields to leave out of the response. |

```bash
# Replace {id} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"courtlistener","path":"/audio/{id}/","method":"GET","query":{"fields":"<string>","omit":"<string>"}}'
```

### Financial disclosure list

Lists federal judges' financial disclosure reports with nested investments, gifts, debts and more. Filter by person.

`GET /financial-disclosures/`

**Estimated cost:** $0.00218

**Page:** https://www.orthogonal.com/api/courtlistener/f44010ce-af7b-4bfc-a02e-3351b9f79f0d

**Docs:** https://wiki.free.law/c/courtlistener/help/api/rest/v4/financial-disclosures

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `fields` | string | No | Comma-separated fields to return; double underscores select nested fields. |
| `omit` | string | No | Comma-separated fields to leave out of the response. |
| `order_by` | string | No | Field to order by (see the endpoint's OPTIONS ordering list); prefix with - for descending, comma-separate tie-breakers. |
| `page` | integer | No | Page number (limited to 100 pages); not used when ordering by id, date_created or date_modified. |
| `cursor` | string | No | Cursor from a previous response's next/previous URL for deep pagination. |
| `count` | string | No | Set to on to return only the total count of matching items. |
| `id` | integer | No | Filter by ID; supports lookups such as id__gt, id__lt, id__range. |
| `person` | integer | No | Judge (person) ID. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"courtlistener","path":"/financial-disclosures/","method":"GET","query":{"fields":"<string>","omit":"<string>","order_by":"<string>","page":"<integer>","cursor":"<string>","count":"<string>","id":"<integer>","person":"<integer>"}}'
```

### Financial disclosure details

One judge's financial disclosure report by ID.

`GET /financial-disclosures/{id}/`

**Estimated cost:** $0.00218

**Page:** https://www.orthogonal.com/api/courtlistener/e87cdd47-1845-4456-8836-d73d20057094

**Docs:** https://wiki.free.law/c/courtlistener/help/api/rest/v4/financial-disclosures

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `fields` | string | No | Comma-separated fields to return; double underscores select nested fields. |
| `omit` | string | No | Comma-separated fields to leave out of the response. |

```bash
# Replace {id} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"courtlistener","path":"/financial-disclosures/{id}/","method":"GET","query":{"fields":"<string>","omit":"<string>"}}'
```

### Judge investments

Lists investments reported in judges' financial disclosures, with value and income codes.

`GET /investments/`

**Estimated cost:** $0.00218

**Page:** https://www.orthogonal.com/api/courtlistener/28a21cd4-0d9d-4d5f-811c-7c6ae465ebd1

**Docs:** https://wiki.free.law/c/courtlistener/help/api/rest/v4/financial-disclosures

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `fields` | string | No | Comma-separated fields to return; double underscores select nested fields. |
| `omit` | string | No | Comma-separated fields to leave out of the response. |
| `order_by` | string | No | Field to order by (see the endpoint's OPTIONS ordering list); prefix with - for descending, comma-separate tie-breakers. |
| `page` | integer | No | Page number (limited to 100 pages); not used when ordering by id, date_created or date_modified. |
| `cursor` | string | No | Cursor from a previous response's next/previous URL for deep pagination. |
| `count` | string | No | Set to on to return only the total count of matching items. |
| `id` | integer | No | Filter by ID; supports lookups such as id__gt, id__lt, id__range. |
| `redacted` | boolean | No | Only rows that contain redactions. |
| `gross_value_code` | string | No | Filter by gross value code (e.g. P4 is over $50,000,000). |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"courtlistener","path":"/investments/","method":"GET","query":{"fields":"<string>","omit":"<string>","order_by":"<string>","page":"<integer>","cursor":"<string>","count":"<string>","id":"<integer>","redacted":"<boolean>","gross_value_code":"<string>"}}'
```

### Judge gifts

Lists gifts over the reporting threshold received by judges.

`GET /gifts/`

**Estimated cost:** $0.00218

**Page:** https://www.orthogonal.com/api/courtlistener/38123876-ab3b-40b3-9a2e-866e3750212a

**Docs:** https://wiki.free.law/c/courtlistener/help/api/rest/v4/financial-disclosures

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `fields` | string | No | Comma-separated fields to return; double underscores select nested fields. |
| `omit` | string | No | Comma-separated fields to leave out of the response. |
| `order_by` | string | No | Field to order by (see the endpoint's OPTIONS ordering list); prefix with - for descending, comma-separate tie-breakers. |
| `page` | integer | No | Page number (limited to 100 pages); not used when ordering by id, date_created or date_modified. |
| `cursor` | string | No | Cursor from a previous response's next/previous URL for deep pagination. |
| `count` | string | No | Set to on to return only the total count of matching items. |
| `id` | integer | No | Filter by ID; supports lookups such as id__gt, id__lt, id__range. |
| `redacted` | boolean | No | Only rows that contain redactions. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"courtlistener","path":"/gifts/","method":"GET","query":{"fields":"<string>","omit":"<string>","order_by":"<string>","page":"<integer>","cursor":"<string>","count":"<string>","id":"<integer>","redacted":"<boolean>"}}'
```

### Judge debts

Lists liabilities reported in judges' financial disclosures.

`GET /debts/`

**Estimated cost:** $0.00218

**Page:** https://www.orthogonal.com/api/courtlistener/b7169475-fd93-4969-a3fa-552574ff1475

**Docs:** https://wiki.free.law/c/courtlistener/help/api/rest/v4/financial-disclosures

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `fields` | string | No | Comma-separated fields to return; double underscores select nested fields. |
| `omit` | string | No | Comma-separated fields to leave out of the response. |
| `order_by` | string | No | Field to order by (see the endpoint's OPTIONS ordering list); prefix with - for descending, comma-separate tie-breakers. |
| `page` | integer | No | Page number (limited to 100 pages); not used when ordering by id, date_created or date_modified. |
| `cursor` | string | No | Cursor from a previous response's next/previous URL for deep pagination. |
| `count` | string | No | Set to on to return only the total count of matching items. |
| `id` | integer | No | Filter by ID; supports lookups such as id__gt, id__lt, id__range. |
| `redacted` | boolean | No | Only rows that contain redactions. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"courtlistener","path":"/debts/","method":"GET","query":{"fields":"<string>","omit":"<string>","order_by":"<string>","page":"<integer>","cursor":"<string>","count":"<string>","id":"<integer>","redacted":"<boolean>"}}'
```

### Judge agreements

Lists agreements and arrangements reported in judges' financial disclosures.

`GET /agreements/`

**Estimated cost:** $0.00218

**Page:** https://www.orthogonal.com/api/courtlistener/3d42f4ed-fe33-4091-8a34-c496a46a422b

**Docs:** https://wiki.free.law/c/courtlistener/help/api/rest/v4/financial-disclosures

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `fields` | string | No | Comma-separated fields to return; double underscores select nested fields. |
| `omit` | string | No | Comma-separated fields to leave out of the response. |
| `order_by` | string | No | Field to order by (see the endpoint's OPTIONS ordering list); prefix with - for descending, comma-separate tie-breakers. |
| `page` | integer | No | Page number (limited to 100 pages); not used when ordering by id, date_created or date_modified. |
| `cursor` | string | No | Cursor from a previous response's next/previous URL for deep pagination. |
| `count` | string | No | Set to on to return only the total count of matching items. |
| `id` | integer | No | Filter by ID; supports lookups such as id__gt, id__lt, id__range. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"courtlistener","path":"/agreements/","method":"GET","query":{"fields":"<string>","omit":"<string>","order_by":"<string>","page":"<integer>","cursor":"<string>","count":"<string>","id":"<integer>"}}'
```

### Judge outside income

Lists judges' non-investment income from their disclosures.

`GET /non-investment-incomes/`

**Estimated cost:** $0.00218

**Page:** https://www.orthogonal.com/api/courtlistener/e320778d-aa65-4dce-ba7c-98bb436d8d65

**Docs:** https://wiki.free.law/c/courtlistener/help/api/rest/v4/financial-disclosures

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `fields` | string | No | Comma-separated fields to return; double underscores select nested fields. |
| `omit` | string | No | Comma-separated fields to leave out of the response. |
| `order_by` | string | No | Field to order by (see the endpoint's OPTIONS ordering list); prefix with - for descending, comma-separate tie-breakers. |
| `page` | integer | No | Page number (limited to 100 pages); not used when ordering by id, date_created or date_modified. |
| `cursor` | string | No | Cursor from a previous response's next/previous URL for deep pagination. |
| `count` | string | No | Set to on to return only the total count of matching items. |
| `id` | integer | No | Filter by ID; supports lookups such as id__gt, id__lt, id__range. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"courtlistener","path":"/non-investment-incomes/","method":"GET","query":{"fields":"<string>","omit":"<string>","order_by":"<string>","page":"<integer>","cursor":"<string>","count":"<string>","id":"<integer>"}}'
```

### Judge spouse income

Lists the source and type of non-investment income of a judge's spouse.

`GET /spouse-incomes/`

**Estimated cost:** $0.00218

**Page:** https://www.orthogonal.com/api/courtlistener/e3f39694-18ff-4150-ba2d-ecaddbc0cb80

**Docs:** https://wiki.free.law/c/courtlistener/help/api/rest/v4/financial-disclosures

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `fields` | string | No | Comma-separated fields to return; double underscores select nested fields. |
| `omit` | string | No | Comma-separated fields to leave out of the response. |
| `order_by` | string | No | Field to order by (see the endpoint's OPTIONS ordering list); prefix with - for descending, comma-separate tie-breakers. |
| `page` | integer | No | Page number (limited to 100 pages); not used when ordering by id, date_created or date_modified. |
| `cursor` | string | No | Cursor from a previous response's next/previous URL for deep pagination. |
| `count` | string | No | Set to on to return only the total count of matching items. |
| `id` | integer | No | Filter by ID; supports lookups such as id__gt, id__lt, id__range. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"courtlistener","path":"/spouse-incomes/","method":"GET","query":{"fields":"<string>","omit":"<string>","order_by":"<string>","page":"<integer>","cursor":"<string>","count":"<string>","id":"<integer>"}}'
```

### Judge reimbursements

Lists travel-related reimbursements reported by judges.

`GET /reimbursements/`

**Estimated cost:** $0.00218

**Page:** https://www.orthogonal.com/api/courtlistener/146497c9-7545-4e8a-99cc-c51d07e94860

**Docs:** https://wiki.free.law/c/courtlistener/help/api/rest/v4/financial-disclosures

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `fields` | string | No | Comma-separated fields to return; double underscores select nested fields. |
| `omit` | string | No | Comma-separated fields to leave out of the response. |
| `order_by` | string | No | Field to order by (see the endpoint's OPTIONS ordering list); prefix with - for descending, comma-separate tie-breakers. |
| `page` | integer | No | Page number (limited to 100 pages); not used when ordering by id, date_created or date_modified. |
| `cursor` | string | No | Cursor from a previous response's next/previous URL for deep pagination. |
| `count` | string | No | Set to on to return only the total count of matching items. |
| `id` | integer | No | Filter by ID; supports lookups such as id__gt, id__lt, id__range. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"courtlistener","path":"/reimbursements/","method":"GET","query":{"fields":"<string>","omit":"<string>","order_by":"<string>","page":"<integer>","cursor":"<string>","count":"<string>","id":"<integer>"}}'
```

### Judge outside positions

Lists non-judicial positions reported in judges' financial disclosures.

`GET /disclosure-positions/`

**Estimated cost:** $0.00218

**Page:** https://www.orthogonal.com/api/courtlistener/330a3491-c5a1-4974-ae73-68cc1f1285af

**Docs:** https://wiki.free.law/c/courtlistener/help/api/rest/v4/financial-disclosures

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `fields` | string | No | Comma-separated fields to return; double underscores select nested fields. |
| `omit` | string | No | Comma-separated fields to leave out of the response. |
| `order_by` | string | No | Field to order by (see the endpoint's OPTIONS ordering list); prefix with - for descending, comma-separate tie-breakers. |
| `page` | integer | No | Page number (limited to 100 pages); not used when ordering by id, date_created or date_modified. |
| `cursor` | string | No | Cursor from a previous response's next/previous URL for deep pagination. |
| `count` | string | No | Set to on to return only the total count of matching items. |
| `id` | integer | No | Filter by ID; supports lookups such as id__gt, id__lt, id__range. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"courtlistener","path":"/disclosure-positions/","method":"GET","query":{"fields":"<string>","omit":"<string>","order_by":"<string>","page":"<integer>","cursor":"<string>","count":"<string>","id":"<integer>"}}'
```

### Legal search

Searches case law, PACER dockets and filings, judges and oral arguments with CourtListener's search engine, using the same parameters as the website. Keyword search by default; semantic=true for semantic case-law search.

`GET /search/`

**Estimated cost:** $0.00327

**Page:** https://www.orthogonal.com/api/courtlistener/92c9234e-e3b8-49e9-bff4-2610aac315eb

**Docs:** https://wiki.free.law/c/courtlistener/help/api/rest/v4/search

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `q` | string | No | Query, with advanced search operators. |
| `type` | string | No | Data to search: o case law (default), r dockets with nested documents, rd PACER filings, d PACER dockets, p judges, oa oral arguments. |
| `order_by` | string | No | Sort order as set by the website's ordering drop-down, e.g. score desc. |
| `highlight` | string | No | Set to on to highlight matches in snippets. |
| `semantic` | boolean | No | Set to true for semantic search (case law only). |
| `cursor` | string | No | Cursor from a previous response's next URL. |
| `stat_Published` | string | No | Include published case law (on). |
| `stat_Unpublished` | string | No | Include unpublished case law (on). |
| `stat_Errata` | string | No | Include errata (on). |
| `stat_Separate` | string | No | Include separate opinions (on). |
| `stat_In-chambers` | string | No | Include in-chambers opinions (on). |
| `stat_Relating-to` | string | No | Include relating-to orders (on). |
| `stat_Unknown` | string | No | Include unknown status (on). |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"courtlistener","path":"/search/","method":"GET","query":{"q":"<string>","type":"<string>","order_by":"<string>","highlight":"<string>","semantic":"<boolean>","cursor":"<string>","stat_Published":"<string>","stat_Unpublished":"<string>","stat_Errata":"<string>","stat_Separate":"<string>","stat_In-chambers":"<string>","stat_Relating-to":"<string>","stat_Unknown":"<string>"}}'
```

### Citation lookup

Finds and verifies legal citations: send a block of text (up to 64,000 characters, up to 250 citations looked up) or one volume/reporter/page, and get each citation's matching CourtListener cases. A guardrail against hallucinated citations.

`POST /citation-lookup/`

**Estimated cost:** $0.00545

**Page:** https://www.orthogonal.com/api/courtlistener/407ec7e5-6668-4c0d-b835-7fff5b7bd63b

**Docs:** https://wiki.free.law/c/courtlistener/help/api/rest/v4/citation-lookup

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `text` | string | No | Text to parse for citations (max 64,000 characters). |
| `volume` | string | No | Citation volume (with reporter and page). |
| `reporter` | string | No | Citation reporter abbreviation. |
| `page` | string | No | Citation page. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"courtlistener","path":"/citation-lookup/","body":{"text":"<string>","volume":"<string>","reporter":"<string>","page":"<string>"}}'
```

---

Full details and an interactive quickstart: https://www.orthogonal.com/publisher/courtlistener
