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

> Retrieve the divisions on a bill and the decisions on its amendments, oldest first.

Returns two kinds of records for a bill, oldest first:

* **Votes** (`kind: "vote"`): divisions, where members' votes are counted, and other recorded votes.
* **Decisions** (`kind: "decision"`): decisions on amendments made without a vote, such as an amendment being withdrawn or not moved.

Records without a date are listed last.

## Path parameters

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

The `id` of the bill.

## Query parameters

**kind** `string`

Only return records of this kind: `vote` or `decision`.

**house** `string`

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

**since** `string`

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

**before** `string`

Only return records 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 votes and decisions, oldest first.

**Vote fields**

**id** `string`

UUID of the record.

**external\_id** `string`

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

**kind** `string`

`"vote"` or `"decision"`.

**source\_name** `string`

Where Parsagon collected the record from, such as `"commons_votes"` or `"uk_amendment_decision"`.

**house** `string`

The house where the vote or decision happened.

**title** `string`

Title of the vote or decision, such as `"Amendment 9 - Withdrawn"`.

**date** `string | null`

When the vote or decision happened (ISO 8601).

**ayes** `integer | null`

Number of votes in favor. `null` for decisions and for votes recorded without counts.

**noes** `integer | null`

Number of votes against. `null` for decisions and for votes recorded without counts.

**result** `string`

Outcome, as given by the legislature, such as `"Not content"` or `"Withdrawn"`. Empty if unavailable.

**is\_committee** `boolean`

Whether the vote happened in a committee.

**linked\_amendment** `string | null`

`id` of the amendment the record is about, from [List bill amendments](https://docs.parsagon.io/api-reference/legislative/list-amendments.md). `null` if the record isn't about an amendment or the amendment isn't available.

**linked\_amendment\_no** `string`

Number of the amendment the record is about. Empty if the record isn't about an amendment.

**subject\_text** `string`

What the vote or decision is about, such as the text of the amendment. Empty if unavailable.

**upstream\_url** `string`

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

**source** `string | null`

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

## Errors

| Status | Meaning |
| - | - |
| `400 Bad Request` | A filter has an invalid value, such as a malformed date or an unknown `kind`. |
| `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": 2,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": "8f4b2d6a-0c1e-4a73-9b58-e2d7f6a1c394",
      "external_id": "2435",
      "kind": "vote",
      "source_name": "commons_votes",
      "house": "Commons",
      "title": "Courts and Tribunals Bill Report Stage: Amendment 1",
      "date": "2026-10-13T18:15:00Z",
      "ayes": 196,
      "noes": 304,
      "result": "Noes",
      "is_committee": false,
      "linked_amendment": "e5a9c3b7-2d4f-4e18-a6c0-9b1d8f7e3a52",
      "linked_amendment_no": "1",
      "subject_text": "Page 1, line 4, leave out Clause 1",
      "upstream_url": "https://votes.parliament.uk/votes/commons/division/2435",
      "source": "6c2e8a14-9f3b-4d07-b5a1-0e7d4c9f2b86"
    },
    {
      "id": "d1f7a3c9-4e8b-4b26-8c05-7a3e9d2f1b40",
      "external_id": "21266:10040284",
      "kind": "decision",
      "source_name": "uk_amendment_decision",
      "house": "Lords",
      "title": "Amendment 9 - Withdrawn",
      "date": "2026-11-10T00:00:00Z",
      "ayes": null,
      "noes": null,
      "result": "Withdrawn",
      "is_committee": false,
      "linked_amendment": "f2b8d4a6-1c3e-4d70-9a5b-7e0c2f8d6b13",
      "linked_amendment_no": "9",
      "subject_text": "This amendment would limit judge-only trials to situations where all of the defendants are to be tried on indictment for one or more offences listed in Schedule 3ZA.",
      "upstream_url": "https://bills.parliament.uk/bills/4083/stages/21266/amendments/10040284",
      "source": null
    }
  ]
}
```

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


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