# Bills API API

> Bills API API on Apizie: 19 endpoints (Returns a list of Bill types., Returns a list of Bills., Return a Bill., Returns a list of news articles for a Bill., …) returned as clean JSON through one API key. 19 endpoints are live now. Call it over REST at https://zieapi.vercel.app/v1/open-data:parliament-uk-bills/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `open-data:parliament-uk-bills`
- Category: Open Data
- Status: live
- Source: https://www.parliament.uk
- Page: https://zieapi.vercel.app/api/open-data/parliament-uk-bills
- OpenAPI: https://zieapi.vercel.app/api/open-data/parliament-uk-bills/openapi.json

API to get and search for information regarding Bills, their stages, associated amendments and publications.

## Endpoints

### Returns a list of Bill types.
`GET https://zieapi.vercel.app/v1/open-data:parliament-uk-bills/get-api-v1-bill-types`

| Parameter | Type | Required | Description |
|---|---|---|---|
| Category | string | no |  |
| Skip | integer | no |  |
| Take | integer | no |  |

### Returns a list of Bills.
`GET https://zieapi.vercel.app/v1/open-data:parliament-uk-bills/get-bills`

| Parameter | Type | Required | Description |
|---|---|---|---|
| SearchTerm | string | no |  |
| Session | integer | no |  |
| CurrentHouse | string | no |  |
| OriginatingHouse | string | no |  |
| MemberId | integer | no |  |
| DepartmentId | integer | no |  |
| BillStage | array | no |  |
| BillStagesExcluded | array | no |  |
| IsDefeated | boolean | no |  |
| IsWithdrawn | boolean | no |  |
| BillType | array | no |  |
| SortOrder | string | no |  |
| BillIds | array | no |  |
| Skip | integer | no |  |
| Take | integer | no |  |

### Return a Bill.
`GET https://zieapi.vercel.app/v1/open-data:parliament-uk-bills/get-bill`

| Parameter | Type | Required | Description |
|---|---|---|---|
| billId | integer | yes | Bill with ID specified |

### Returns a list of news articles for a Bill.
`GET https://zieapi.vercel.app/v1/open-data:parliament-uk-bills/get-news-articles`

| Parameter | Type | Required | Description |
|---|---|---|---|
| billId | integer | yes |  |
| Skip | integer | no |  |
| Take | integer | no |  |

### Return a list of Bill publications.
`GET https://zieapi.vercel.app/v1/open-data:parliament-uk-bills/get-bill-publication`

| Parameter | Type | Required | Description |
|---|---|---|---|
| billId | integer | yes | Publications relating to Bill with Bill ID specified |

### Returns all Bill stages.
`GET https://zieapi.vercel.app/v1/open-data:parliament-uk-bills/get-api-v1-bills-bill-id-stages`

| Parameter | Type | Required | Description |
|---|---|---|---|
| billId | integer | yes | Stages relating to a Bill with Bill ID specified |
| Skip | integer | no |  |
| Take | integer | no |  |

### Returns a Bill stage.
`GET https://zieapi.vercel.app/v1/open-data:parliament-uk-bills/get-bill-stage-details`

| Parameter | Type | Required | Description |
|---|---|---|---|
| billId | integer | yes | Bill stage relating to Bill with Bill ID specified |
| billStageId | integer | yes | Bill stage with ID specified |

### Returns a list of amendments.
`GET https://zieapi.vercel.app/v1/open-data:parliament-uk-bills/get-amendments`

| Parameter | Type | Required | Description |
|---|---|---|---|
| billId | integer | yes | Amendments relating to a Bill with Bill ID specified |
| billStageId | integer | yes | Amendments relating to a Bill stage with Bill stage ID specified |
| SearchTerm | string | no |  |
| Decision | string | no |  |
| MemberId | integer | no |  |
| Skip | integer | no |  |
| Take | integer | no |  |

### Returns an amendment.
`GET https://zieapi.vercel.app/v1/open-data:parliament-uk-bills/get-amendment`

| Parameter | Type | Required | Description |
|---|---|---|---|
| billId | integer | yes | Amendment relating to a bill with bill ID specified |
| billStageId | integer | yes | Amendment relating to a bill stage with bill stage ID specified |
| amendmentId | integer | yes | Amendment with amendment ID specified |

### Return a list of Bill stage publications.
`GET https://zieapi.vercel.app/v1/open-data:parliament-uk-bills/get-api-v1-bills-bill-id-stages-stage-id-publications`

| Parameter | Type | Required | Description |
|---|---|---|---|
| billId | integer | yes |  |
| stageId | integer | yes |  |

### Returns a list of publication types.
`GET https://zieapi.vercel.app/v1/open-data:parliament-uk-bills/get-api-v1-publication-types`

| Parameter | Type | Required | Description |
|---|---|---|---|
| Skip | integer | no |  |
| Take | integer | no |  |

### Return information on a document.
`GET https://zieapi.vercel.app/v1/open-data:parliament-uk-bills/get-api-v1-publications-publication-id-documents-document-id`

| Parameter | Type | Required | Description |
|---|---|---|---|
| publicationId | integer | yes | Document with publication Id specified |
| documentId | integer | yes | Document with Id specified |

### Return a document.
`GET https://zieapi.vercel.app/v1/open-data:parliament-uk-bills/get-api-v1-publications-publication-id-documents-document-id-2`

| Parameter | Type | Required | Description |
|---|---|---|---|
| publicationId | integer | yes | Document with publication Id specified |
| documentId | integer | yes | Document with Id specified |

### Returns an Rss feed of a certain Bill.
`GET https://zieapi.vercel.app/v1/open-data:parliament-uk-bills/get-api-v1-rss-bills-id-rss`

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | integer | yes | Id of Bill |

### Returns an Rss feed of all Bills.
`GET https://zieapi.vercel.app/v1/open-data:parliament-uk-bills/get-api-v1-rss-allbills-rss`

### Returns an Rss feed of private Bills.
`GET https://zieapi.vercel.app/v1/open-data:parliament-uk-bills/get-api-v1-rss-privatebills-rss`

### Returns an Rss feed of public Bills.
`GET https://zieapi.vercel.app/v1/open-data:parliament-uk-bills/get-api-v1-rss-publicbills-rss`

### Returns a list of Sittings.
`GET https://zieapi.vercel.app/v1/open-data:parliament-uk-bills/get-sittings`

| Parameter | Type | Required | Description |
|---|---|---|---|
| House | string | no |  |
| DateFrom | string | no |  |
| DateTo | string | no |  |
| Skip | integer | no |  |
| Take | integer | no |  |

### Returns a list of Bill stages.
`GET https://zieapi.vercel.app/v1/open-data:parliament-uk-bills/get-api-v1-stages`

| Parameter | Type | Required | Description |
|---|---|---|---|
| Skip | integer | no |  |
| Take | integer | no |  |

## Example
```
curl "https://zieapi.vercel.app/v1/open-data:parliament-uk-bills/get-api-v1-bill-types" \
  -H "x-api-key: $APIZIE_KEY"
```

## FAQ

### How do I call the Bills API API?
Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/open-data:parliament-uk-bills/get-api-v1-bill-types with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Bills API API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card.

### Can AI agents use the Bills API API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key open-data:parliament-uk-bills.

### What is the status of the Bills API API?
Live: works with just an Apizie key