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

> Retrieve contributions to debates on a bill, with their text, oldest first.

Returns contributions to debates on a bill, with their full text, ordered by sitting date, oldest first. Speeches without a sitting date are listed last.

Speeches come from the legislature's official record of debates. Some legislatures publish this record weeks after the debate. For example, Dutch speeches are published about 6 weeks after the debate.

## Path parameters

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

The `id` of the bill.

## Query parameters

**house** `string`

Only return speeches from this house, such as `Commons`. Must match the speech's `house` exactly.

**kind** `string`

Only return speeches of this kind: `COMMITMENT`, `RESPONSE`, or `EVIDENCE`. See the `kind` response field.

**is\_minister** `boolean`

Set to `true` to only return speeches by ministers, or `false` to exclude them.

**since** `string`

Only return speeches with a sitting date at or after this time (ISO 8601).

**before** `string`

Only return speeches with a sitting date 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 speeches, oldest first.

**Speech fields**

**id** `string`

UUID of the speech.

**external\_id** `string`

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

**debate\_external\_id** `string`

The ID of the debate in the legislature's own system.

**debate\_title** `string`

Title of the debate.

**house** `string`

The house where the debate happened. Empty if unavailable.

**sitting\_date** `string | null`

Date of the sitting (ISO 8601).

**speaker\_name** `string`

Name of the speaker.

**speaker\_party** `string`

The speaker's party, as a short key such as `"lab"`. Empty if unknown.

**external\_member\_id** `string`

The speaker's member ID in the legislature's own system. Empty if unavailable.

**ministerial\_role** `string`

The speaker's ministerial role. Empty if the speaker isn't a minister.

**is\_minister** `boolean`

Whether the speaker is a minister.

**kind** `string`

Classification of a minister's speech:

* `"COMMITMENT"`: the minister makes a commitment, such as promising to write to members or bring forward an amendment.
* `"RESPONSE"`: a substantive response from the minister.
* `"EVIDENCE"`: a question in an evidence session.

Empty for other speeches.

**commitment\_phrase** `string`

The phrase that marks the commitment, such as `"I will write"` or `"I can confirm"`. Empty if the speech isn't a commitment.

**upstream\_url** `string`

URL of the speech in the legislature's official record.

**source** `string | null`

`uuid` of the `"LEGISLATION"` source for the speech. `null` if Parsagon hasn't created one.

**text** `string | null`

Full text of the speech. `null` if the text isn't available.

## 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": "a2c6e0f4-8b1d-4f39-9e75-3d0b6a8c2f17",
      "external_id": "5C7E2A19-3B84-4D6F-A0E1-9F2B6C8D4A73",
      "debate_external_id": "8E1F2A3B-4C5D-4E7F-8091-A2B3C4D5E6F7",
      "debate_title": "Courts and Tribunals Bill",
      "house": "Commons",
      "sitting_date": "2026-10-13T00:00:00Z",
      "speaker_name": "Sarah Sackman",
      "speaker_party": "lab",
      "external_member_id": "5204",
      "ministerial_role": "Minister of State (Ministry of Justice)",
      "is_minister": true,
      "kind": "COMMITMENT",
      "commitment_phrase": "I can confirm",
      "upstream_url": "https://hansard.parliament.uk/Commons/2026-10-13/debates/8E1F2A3B-4C5D-4E7F-8091-A2B3C4D5E6F7/CourtsAndTribunalsBill#contribution-5C7E2A19-3B84-4D6F-A0E1-9F2B6C8D4A73",
      "source": "4b9d1e7a-6c3f-4a82-b0e5-2f8c7d1a9e36",
      "text": "I can confirm that the Government will bring forward an amendment in the other place."
    }
  ]
}
```

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


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