curl --request GET \
--url https://astreus.ai/api/v1/congressional/calendar \
--header 'X-API-KEY: <api-key>'import requests
url = "https://astreus.ai/api/v1/congressional/calendar"
headers = {"X-API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};
fetch('https://astreus.ai/api/v1/congressional/calendar', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://astreus.ai/api/v1/congressional/calendar",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-KEY: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://astreus.ai/api/v1/congressional/calendar"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-KEY", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://astreus.ai/api/v1/congressional/calendar")
.header("X-API-KEY", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://astreus.ai/api/v1/congressional/calendar")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"events": [
{
"id": "house:119515",
"chamber": "house",
"eventId": "119515",
"congress": 119,
"date": "2026-09-01",
"meetingAt": "2026-09-01T14:00:00.000Z",
"time": "10:00 AM",
"title": "Countering Houthi Terrorism: Protecting U.S. Interests and Security in the Red Sea",
"kind": "hearing",
"meetingType": "Hearing",
"closed": false,
"status": "scheduled",
"location": "Rayburn House Office Building 2172",
"committees": [
{
"systemCode": "hsfa13",
"name": "House Subcommittee on the Middle East and North Africa",
"parentSystemCode": "hsfa00"
}
],
"witnessCount": 2,
"url": "https://www.congress.gov/event/119th-congress/house-event/119515"
},
{
"id": "house:119516",
"chamber": "house",
"eventId": "119516",
"congress": 119,
"date": "2026-09-01",
"meetingAt": "2026-09-01T14:00:00.000Z",
"time": "10:00 AM",
"title": "“Sanctuary Policies, Tragic Consequences”",
"kind": "hearing",
"meetingType": "Hearing",
"closed": false,
"status": "scheduled",
"location": "Rayburn House Office Building 2141",
"committees": [
{
"systemCode": "hsju01",
"name": "House Subcommittee on Immigration Integrity, Security, and Enforcement",
"parentSystemCode": "hsju00"
}
],
"witnessCount": 4,
"url": "https://www.congress.gov/event/119th-congress/house-event/119516"
}
],
"days": [
{
"chamber": "house",
"date": "2026-09-01",
"status": "in_session",
"conveneAt": "2026-09-01T15:00:00.000Z",
"conveneText": "11 a.m.",
"adjournedAt": "2026-09-02T00:23:00.000Z",
"adjournedText": "8:23 p.m.",
"ranPastMidnight": false,
"statusFrom": null,
"program": null,
"basis": "congressional_record",
"bases": [
"annual_calendar",
"congressional_record"
],
"observedOn": "2026-09-01",
"sourceRef": "CREC-2026-09-01-pt1-PgD854-3"
},
{
"chamber": "senate",
"date": "2026-09-02",
"status": "not_in_session",
"conveneAt": null,
"conveneText": null,
"adjournedAt": null,
"adjournedText": null,
"ranPastMidnight": false,
"statusFrom": null,
"program": null,
"basis": "congressional_record",
"bases": [
"congressional_record"
],
"observedOn": "2026-09-02",
"sourceRef": "CREC-2026-09-02-pt1-PgD859"
}
],
"horizon": {
"house": {
"publishedThrough": "2026-12-31",
"note": "The House publishes an annual calendar of session days and district work periods, and the Daily Digest announces each sitting the day before."
},
"senate": {
"publishedThrough": "2026-11-02",
"note": "The Senate publishes no machine-readable forward calendar — senate.gov refuses automated access — so its days come from the Congressional Record and reach only as far as the last Daily Digest's announ…"
}
},
"summary": {
"hearing": 82,
"markup": 11,
"business": 17
},
"total": 110,
"truncated": false,
"generatedAt": "2026-11-01T12:49:09.510Z",
"offset": 0,
"limit": 2,
"nextOffset": 2
}{
"error": "<string>",
"code": "unknown_parameter",
"param": "<string>",
"allowed": [
"<string>"
]
}{
"error": "<string>",
"code": "unknown_parameter",
"param": "<string>",
"allowed": [
"<string>"
]
}{
"error": "<string>",
"code": "unknown_parameter",
"param": "<string>",
"allowed": [
"<string>"
]
}{
"error": "<string>",
"code": "unknown_parameter",
"param": "<string>",
"allowed": [
"<string>"
]
}Congressional calendar
US House and Senate committee meetings in a window (up to 93 days, Washington days), each chamber’s session days, and how far each chamber’s published calendar reaches. Cancelled and postponed meetings keep their status. limit/offset page the meetings; session days are always whole.
curl --request GET \
--url https://astreus.ai/api/v1/congressional/calendar \
--header 'X-API-KEY: <api-key>'import requests
url = "https://astreus.ai/api/v1/congressional/calendar"
headers = {"X-API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};
fetch('https://astreus.ai/api/v1/congressional/calendar', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://astreus.ai/api/v1/congressional/calendar",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-KEY: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://astreus.ai/api/v1/congressional/calendar"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-KEY", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://astreus.ai/api/v1/congressional/calendar")
.header("X-API-KEY", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://astreus.ai/api/v1/congressional/calendar")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"events": [
{
"id": "house:119515",
"chamber": "house",
"eventId": "119515",
"congress": 119,
"date": "2026-09-01",
"meetingAt": "2026-09-01T14:00:00.000Z",
"time": "10:00 AM",
"title": "Countering Houthi Terrorism: Protecting U.S. Interests and Security in the Red Sea",
"kind": "hearing",
"meetingType": "Hearing",
"closed": false,
"status": "scheduled",
"location": "Rayburn House Office Building 2172",
"committees": [
{
"systemCode": "hsfa13",
"name": "House Subcommittee on the Middle East and North Africa",
"parentSystemCode": "hsfa00"
}
],
"witnessCount": 2,
"url": "https://www.congress.gov/event/119th-congress/house-event/119515"
},
{
"id": "house:119516",
"chamber": "house",
"eventId": "119516",
"congress": 119,
"date": "2026-09-01",
"meetingAt": "2026-09-01T14:00:00.000Z",
"time": "10:00 AM",
"title": "“Sanctuary Policies, Tragic Consequences”",
"kind": "hearing",
"meetingType": "Hearing",
"closed": false,
"status": "scheduled",
"location": "Rayburn House Office Building 2141",
"committees": [
{
"systemCode": "hsju01",
"name": "House Subcommittee on Immigration Integrity, Security, and Enforcement",
"parentSystemCode": "hsju00"
}
],
"witnessCount": 4,
"url": "https://www.congress.gov/event/119th-congress/house-event/119516"
}
],
"days": [
{
"chamber": "house",
"date": "2026-09-01",
"status": "in_session",
"conveneAt": "2026-09-01T15:00:00.000Z",
"conveneText": "11 a.m.",
"adjournedAt": "2026-09-02T00:23:00.000Z",
"adjournedText": "8:23 p.m.",
"ranPastMidnight": false,
"statusFrom": null,
"program": null,
"basis": "congressional_record",
"bases": [
"annual_calendar",
"congressional_record"
],
"observedOn": "2026-09-01",
"sourceRef": "CREC-2026-09-01-pt1-PgD854-3"
},
{
"chamber": "senate",
"date": "2026-09-02",
"status": "not_in_session",
"conveneAt": null,
"conveneText": null,
"adjournedAt": null,
"adjournedText": null,
"ranPastMidnight": false,
"statusFrom": null,
"program": null,
"basis": "congressional_record",
"bases": [
"congressional_record"
],
"observedOn": "2026-09-02",
"sourceRef": "CREC-2026-09-02-pt1-PgD859"
}
],
"horizon": {
"house": {
"publishedThrough": "2026-12-31",
"note": "The House publishes an annual calendar of session days and district work periods, and the Daily Digest announces each sitting the day before."
},
"senate": {
"publishedThrough": "2026-11-02",
"note": "The Senate publishes no machine-readable forward calendar — senate.gov refuses automated access — so its days come from the Congressional Record and reach only as far as the last Daily Digest's announ…"
}
},
"summary": {
"hearing": 82,
"markup": 11,
"business": 17
},
"total": 110,
"truncated": false,
"generatedAt": "2026-11-01T12:49:09.510Z",
"offset": 0,
"limit": 2,
"nextOffset": 2
}{
"error": "<string>",
"code": "unknown_parameter",
"param": "<string>",
"allowed": [
"<string>"
]
}{
"error": "<string>",
"code": "unknown_parameter",
"param": "<string>",
"allowed": [
"<string>"
]
}{
"error": "<string>",
"code": "unknown_parameter",
"param": "<string>",
"allowed": [
"<string>"
]
}{
"error": "<string>",
"code": "unknown_parameter",
"param": "<string>",
"allowed": [
"<string>"
]
}Authorizations
Astreus API key (pk_live_...), created on the Developers page in the terminal. Also accepted as Authorization: Bearer pk_live_....
Query Parameters
First day, YYYY-MM-DD (default today).
Last day, YYYY-MM-DD (default from).
One chamber: house or senate (joint meetings are returned only when no chamber is given).
house, senate Comma-separated: hearing, markup, business.
Committee system code, e.g. ssbk00.
Meeting title or location contains (case-insensitive); max 100 characters.
Page size, 1–500 (500 when only offset is given); with offset, pages the window (nextOffset names the next page). Without both, the whole window.
1 <= x <= 500Rows to skip, default 0.
x >= 0Response
OK
Inferred from captured responses: every field shown was returned by a real call; a field may be absent or null on other calls.