---
title: "List legislative agenda events"
method: GET
path: "/v1/schedules"
tags: ["Schedules"]
---

# List legislative agenda events

`GET /v1/schedules`

## Request

- Base URL: `https://api.dapperglobal.com`
- URL: `https://api.dapperglobal.com/v1/schedules`
- Auth: API key in header `X-API-Key`

Authoritative legislative agenda (sesiones, audiencias, debates, comisiones), sourced directly from each congress's official session calendar (see 'Data sources' below), refreshed every 1-2 hours on session days. Use it for 'upcoming committee hearings in [country] next week' type questions.

Paginated across countries. `country_code` is comma-separated (e.g. `BR,CO`); omit for all accessible. Use `since`/`until` (YYYY-MM-DD) to retrieve upcoming or past events — e.g. since=today until=today+7 for the week ahead — they filter on `event_date` (the actual session/hearing date), not `created_at`. Results are ordered by ingestion recency by default; `order_by=event_date` gives chronological order across pages (`event_date_desc` for the latest sessions first). Rows carry `commission_name` and `bill_title` next to their ids. Optionally narrow to one commission with `commission_id` (use list_commissions to discover IDs). Use `q` to search by title — accent/case/whitespace-insensitive.

**Data sources:** the official legislative agendas and session calendars published by each congress, refreshed every 1-2 hours on session days. ⚠️ No source-document URL is available for the agenda event itself — if it's tied to a bill, use `get_bill`/`congress_records` on that bill for a citable link instead of expecting one here.

## Query parameters

- `limit` integer
- `cursor` string, nullable
- `since` string, date, nullable: Only events happening on or after this date (YYYY-MM-DD). Filters on event_date, not created_at.
- `until` string, date, nullable: Only events happening on or before this date (YYYY-MM-DD). Filters on event_date, not created_at.
- `commission_id` integer, nullable: Filter by commission ID. Use list_commissions(country_code=...) to discover valid IDs.
- `q` string, nullable: Search the event title and its subject/body — accent- and case-insensitive; every token must appear in one of them. The topic of a Colombian session is in the body, not the title.
- `order_by` 'ingested' | 'event_date' | 'event_date_desc': 'ingested' (default): newest-ingested first. 'event_date': chronological, earliest session first (use with since=today). 'event_date_desc': latest session first. A cursor only continues the order it was issued for.
- `country_code` string, nullable: Comma-separated country codes, e.g. BR,CO,CL.
- `country_id` string, nullable: Deprecated alias: comma-separated numeric ids, e.g. 8,2,6.

## Response `200`

Successful response (real sample data)

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/dapperglobal/apis/dapper-political-intelligence-api.md) · [All operations](https://skmtc.dev/dapperglobal/apis/dapper-political-intelligence-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dapperglobal/apis/dapper-political-intelligence-api/revisions/f34d9e6a2b0e?raw)