Skip to main content
GET
Judiciary data

Authorizations

X-API-KEY
string
header
default:pk_live_YOUR_KEY
required

Astreus API key (pk_live_...), created on the Developers page in the terminal. Also accepted as Authorization: Bearer pk_live_....

Path Parameters

iso
string
required

ISO 3166-1 alpha-2 country code (e.g. US).

view
enum<string>
required
Available options:
scotus,
courts,
judges,
opinions,
advocates

Query Parameters

section
string

Row arrays of the view to page, comma-separated; the others are left out. scotus: inProgress, decided, precedent, recentOrders, terms. courts: tiers, byState, federalAppellate, federalDistricts, stateSupreme, prosecutors. judges: tiers, byPresident, recent, supremeCourt. opinions: byCourt, byNatureSuit, recent. advocates: topByCases, topFirms. limit, offset or q without section is a 400.

limit
integer
default:50

Rows per section, 1–200, default 50.

Required range: 1 <= x <= 200
offset
integer
default:0

Rows to skip per section.

Required range: x >= 0
q
string

Words that filter each section's rows.

Response

OK

Inferred from captured responses: every field shown was returned by a real call; a field may be absent or null on other calls.

available
boolean
iso2
string
currentTerm
integer
counts
object
decided
object[]
pages
object