Skip to main content
GET
Legislative bills

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 alpha-2 country code.

Query Parameters

congress
string

Congress number (1–200) or all; default the newest held. A congress not held falls back to the newest.

stage
enum<string>

Action stage.

Available options:
introduced,
passed_one,
cleared,
law,
vetoed
voted
enum<string>

1 to require a recorded vote.

Available options:
1,
0
q
string

Title contains; max 120 characters.

limit
integer
default:50

Rows per page, 1–200; default 50.

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

Rows to skip.

Required range: x >= 0

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.

iso2
string
available
boolean
load
object
congress
integer | null
congresses
integer[]
stage
null
voted
boolean
query
null
total
integer
stageCounts
object
votedCounts
object
offset
integer
limit
integer
bills
object[]