> ## 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 actions

> Retrieve the full history of a bill, oldest first.

Returns the steps in a bill's history, such as readings, stages, decisions, and publications, oldest first. This is the bill's full history from the legislature, including steps from before Parsagon started tracking the bill.

## Path parameters

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

The `id` of the bill.

## Query parameters

**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 actions, oldest first.

**Action fields**

**id** `string`

UUID of the action.

**external\_id** `string`

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

**date** `string | null`

When the action happened (ISO 8601).

**house** `string`

The house where the action happened. Empty if unavailable.

**text** `string`

Description of the action, in English.

**source\_language\_text** `string`

Description of the action in the legislature's own language. Empty if the original is in English.

**action\_type** `string`

Type of action, as given by the legislature. Empty if unavailable.

**upstream\_url** `string`

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

## Errors

| Status | Meaning |
| - | - |
| `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": 16,
  "next": "https://parsagon.io/api/legislative/v1/bills/b8e2d4f0-1a3c-4e5b-8d7f-6c9a0b2e4d61/actions/?limit=2&offset=2",
  "previous": null,
  "results": [
    {
      "id": "0e6f2a91-3c7d-4b58-a1e4-9d2b7c5f8a30",
      "external_id": "20520:17844",
      "date": "2026-02-25T00:00:00Z",
      "house": "Commons",
      "text": "1st reading",
      "source_language_text": "",
      "action_type": "",
      "upstream_url": "https://bills.parliament.uk/bills/4083/stages/20520"
    },
    {
      "id": "7b3d9e15-6a2c-4f80-8e47-1c5a0d9b2f63",
      "external_id": "20523:17897",
      "date": "2026-03-10T00:00:00Z",
      "house": "Commons",
      "text": "2nd reading",
      "source_language_text": "",
      "action_type": "",
      "upstream_url": "https://bills.parliament.uk/bills/4083/stages/20523"
    }
  ]
}
```

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


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