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

> List bills in the jurisdictions you can access, most recently updated first.

Returns the bills in the jurisdictions you can access, most recently updated first. Results use cursor pagination.

To poll for new bills and new activity on existing bills, use `updated_since`. See [Polling for changes](https://docs.parsagon.io/api-reference/legislative/overview.md#polling-for-changes).

## Query parameters

**jurisdiction** `string`

Only return bills from these jurisdictions. Pass one or more comma-separated codes from [List jurisdictions](https://docs.parsagon.io/api-reference/legislative/list-jurisdictions.md), such as `GB`.

**updated\_since** `string`

Only return bills that Parsagon updated at or after this time (ISO 8601). Filters on the bill's `last_seen`.

**updated\_before** `string`

Only return bills that Parsagon last updated before this time (ISO 8601). Filters on the bill's `last_seen`.

**introduced\_since** `string`

Only return bills introduced at or after this time (ISO 8601).

**status\_normalized** `string`

Only return bills with this status: `INTRODUCED`, `CONSIDERING`, `PASSED`, `FAILED`, `INACTIVE`, or `OTHER`.

**session** `string`

Only return bills from this session. Use the legislature's session ID, as in the bill's `session` field.

**is\_act** `boolean`

Set to `true` to only return bills that have become acts, or `false` to exclude them.

**page\_size** `number`

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

**cursor** `string`

Cursor token from the previous response's `next` or `previous` URL.

## Response

**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 bills, most recently updated first.

**Bill fields**

**id** `string`

UUID of the bill.

**jurisdiction** `object`

The legislature the bill belongs to, with a `code` (for example, `"GB"`) and a `name`. See [List jurisdictions](https://docs.parsagon.io/api-reference/legislative/list-jurisdictions.md).

**external\_id** `string`

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

**title** `string`

Short title of the bill.

**long\_title** `string`

Long title of the bill. Empty if unavailable.

**bill\_type** `string`

Bill subtype, such as `"Government Bill"` or `"Private Members' Bill (Presentation Bill)"`. Empty if unavailable.

**session** `string`

The legislature's ID for the session, such as `"40"` or `"2025-2026"`.

**session\_name** `string`

Display name of the session, such as `"2026-27 session"`.

**introduction\_date** `string | null`

When the bill was introduced (ISO 8601).

**current\_house** `string`

The house currently considering the bill.

**current\_stage** `string`

The stage the bill is currently at, in the legislature's own language.

**current\_stage\_date** `string | null`

When the bill's most recent step happened (ISO 8601). If the current stage has several sittings, this is the latest one so far. If the current stage hasn't started yet, this is the date of the bill's last step before it.

**status\_normalized** `string`

The bill's status, normalized across jurisdictions. One of `"INTRODUCED"`, `"CONSIDERING"`, `"PASSED"`, `"FAILED"`, `"INACTIVE"`, or `"OTHER"`. Empty if unknown.

**originating\_house** `string`

The house the bill was introduced in.

**is\_act** `boolean`

Whether the bill has become an act.

**last\_update** `string`

When the legislature last updated the bill (ISO 8601).

**next\_event\_date** `string | null`

Date of the bill's next scheduled event (ISO 8601).

**next\_event\_description** `string`

Description of the bill's next scheduled event.

**amendments\_as\_at** `string | null`

When the bill's amendment list was last published (ISO 8601).

**upstream\_url** `string`

URL of the bill's page on the legislature's website.

**source** `string | null`

`uuid` of the `"LEGISLATION"` source that holds the bill's current text. `null` if the current text hasn't been collected.

**first\_seen** `string`

When Parsagon first collected the bill (ISO 8601).

**last\_seen** `string`

When Parsagon last collected a change to the bill (ISO 8601). The `updated_since` and `updated_before` filters on [List bills](https://docs.parsagon.io/api-reference/legislative/list-bills.md) use this field.

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

```json Example response theme={null}
{
  "next": "https://parsagon.io/api/legislative/v1/bills/?cursor=cD0yMDI2LTExLTEyKzA2JTNBMTUlM0EwMyUyQjAwJTNBMDA%3D&updated_since=2026-11-12T00%3A00%3A00Z",
  "previous": null,
  "results": [
    {
      "id": "b8e2d4f0-1a3c-4e5b-8d7f-6c9a0b2e4d61",
      "jurisdiction": {
        "code": "GB",
        "name": "United Kingdom"
      },
      "external_id": "4083",
      "title": "Courts and Tribunals Bill",
      "long_title": "A Bill to Make provision in relation to criminal courts in England and Wales; to make provision about the leadership of tribunals; to amend section 1 of the Children Act 1989 to remove the presumption relating to the involvement of parents in the life of a child; and for connected purposes.",
      "bill_type": "Government Bill",
      "session": "40",
      "session_name": "2026-27 session",
      "introduction_date": "2026-02-25T00:00:00Z",
      "current_house": "Lords",
      "current_stage": "Committee stage",
      "current_stage_date": "2026-11-10T00:00:00Z",
      "status_normalized": "CONSIDERING",
      "originating_house": "Commons",
      "is_act": false,
      "last_update": "2026-11-11T17:05:31.482916Z",
      "next_event_date": "2026-11-16T00:00:00Z",
      "next_event_description": "Committee stage",
      "amendments_as_at": "2026-11-12T00:00:00Z",
      "upstream_url": "https://bills.parliament.uk/bills/4083",
      "source": "9a7e6b14-2c5d-4f80-b3e1-7d2c8f05a6b9",
      "first_seen": "2026-02-25T19:02:41.583120Z",
      "last_seen": "2026-11-12T06:15:03.271904Z"
    }
  ]
}
```

```bash cURL theme={null}
curl -X GET "https://parsagon.io/api/legislative/v1/bills/?jurisdiction=GB&updated_since=2026-11-12T00:00:00Z" \
  -H "Authorization: Token YOUR_API_KEY_HERE"
```


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