> ## Documentation Index
> Fetch the complete documentation index at: https://docs.parsagon.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List bill events

> Retrieve sittings, debates, and other activities on a bill, past and scheduled.

Returns sittings, hearings, debates, and other activities on a bill, oldest first. This includes both past and scheduled events. Events without a date are listed last.

Votes aren't events. To retrieve them, use [List bill votes](https://docs.parsagon.io/api-reference/legislative/list-votes.md).

## Path parameters

**bill\_id** `string` *required*

The `id` of the bill.

## Query parameters

**status** `string`

Only return events with this status, such as `Scheduled`. Must match the event's `status` exactly.

**since** `string`

Only return events dated at or after this time (ISO 8601).

**before** `string`

Only return events dated before this time (ISO 8601).

**limit** `number`

The maximum number of records to return. Defaults to `100`; maximum `500`.

**offset** `number`

The number of records to skip. Defaults to `0`.

## Response

**count** `integer`

Total number of records that match the query.

**next** `string | null`

URL for the next page of results, or `null` if this is the last page.

**previous** `string | null`

URL for the previous page of results, or `null` if this is the first page.

**results** `array`

Array of events, oldest first.

**Event fields**

**id** `string`

UUID of the event.

**external\_id** `string`

The event's ID in the legislature's own system.

**date** `string | null`

When the event happened or is scheduled (ISO 8601).

**house** `string`

The house holding the event. Empty if unavailable.

**event\_type** `string`

Type of event, such as `"Committee stage"`. Empty if unavailable.

**title** `string`

Title of the event. Empty if unavailable.

**status** `string`

Status of the event. Usually one of `"Scheduled"`, `"Held"`, `"Cancelled"`, or `"Postponed"`. If the legislature's status doesn't map to one of these, this is the legislature's own status. Empty if unknown.

**result** `string`

Outcome of the event. Empty if unavailable.

**upstream\_url** `string`

URL of the event on the legislature's website. Empty if unavailable.

## Errors

| Status | Meaning |
| - | - |
| `400 Bad Request` | A filter has an invalid value, such as a malformed date. |
| `403 Forbidden` | Your account doesn't have a valid subscription or hasn't accepted the Terms of Service. |
| `404 Not Found` | No bill has this `id`, or the bill belongs to a jurisdiction you can't access. |

```json Example response theme={null}
{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": "3a8c1f60-5e2b-4d97-b0a4-6f1e8c3d7b25",
      "external_id": "18698",
      "date": "2026-11-16T00:00:00Z",
      "house": "Lords",
      "event_type": "Committee stage",
      "title": "Committee stage",
      "status": "Scheduled",
      "result": "",
      "upstream_url": "https://bills.parliament.uk/bills/4083/stages/21266"
    }
  ]
}
```

```bash cURL theme={null}
curl -X GET "https://parsagon.io/api/legislative/v1/bills/b8e2d4f0-1a3c-4e5b-8d7f-6c9a0b2e4d61/events/?status=Scheduled" \
  -H "Authorization: Token YOUR_API_KEY_HERE"
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.