---
title: "Bills Search"
method: GET
path: "/bills"
tags: ["bills"]
---

# Bills Search

`GET /bills`

Search for bills matching given criteria.

Must either specify a jurisdiction or a full text query (q).  Additional parameters will
futher restrict bills returned.

## Query parameters

- `jurisdiction` string — Filter by jurisdiction name or ID.
- `session` string — Filter by session identifier.
- `chamber` string — Filter by chamber of origination.
- `identifier` string[] — Filter to only include bills with this identifier.
- `classification` string — Filter by classification, e.g. bill or resolution
- `subject` string[] — Filter by one or more subjects.
- `updated_since` string — Filter to only include bills with updates since a given date.
- `created_since` string — Filter to only include bills created since a given date.
- `action_since` string — Filter to only include bills with an action since a given date.
- `sort` 'updated_asc' | 'updated_desc' | 'first_action_asc' | 'first_action_desc' | 'latest_action_asc' | 'latest_action_desc' — An enumeration.
- `sponsor` string — Filter to only include bills sponsored by a given name or person ID.
- `sponsor_classification` string — Filter matched sponsors to only include particular types of sponsorships.
- `q` string — Filter by full text search term.
- `include` BillInclude[] — Additional information to include in response.
- `page` integer
- `per_page` integer
- `apikey` string

## Headers

- `x-api-key` string

## Response `200`

Successful Response

- BillList
  - `results` Bill[], required
    - `id` string, required
    - `session` string, required
    - `jurisdiction` CompactJurisdiction, required
      - `id` string, required
      - `name` string, required
      - `classification` 'state' | 'municipality' | 'country', required — An enumeration.
    - `from_organization` Organization, required
      - `id` string, required
      - `name` string, required
      - `classification` string, required
    - `identifier` string, required
    - `title` string, required
    - `classification` string[]
    - `subject` string[]
    - `extras` object
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `openstates_url` string, required
    - `first_action_date` string
    - `latest_action_date` string
    - `latest_action_description` string
    - `latest_passage_date` string
    - `related_bills` RelatedBill[]
      - `identifier` string, required
      - `legislative_session` string, required
      - `relation_type` string, required
    - `abstracts` BillAbstract[]
      - `abstract` string, required
      - `note` string, required
    - `other_titles` BillTitle[]
      - `title` string, required
      - `note` string, required
    - `other_identifiers` BillIdentifier[]
      - `identifier` string, required
    - `sponsorships` BillSponsorship[]
      - `id` string, uuid, required
      - `name` string, required
      - `entity_type` string, required
      - `organization` Organization
        - `id` string, required
        - `name` string, required
        - `classification` string, required
      - `person` CompactPerson
        - `id` string, required
        - `name` string, required
        - `party` string, required
        - `current_role` CurrentRole
          - `title` string, required
          - `org_classification` 'legislature' | 'executive' | 'lower' | 'upper' | 'government', required — An enumeration.
          - `district` union
            - string
            - integer
          - `division_id` string
      - `primary` boolean, required
      - `classification` string, required
    - `actions` BillAction[]
      - `id` string, uuid, required
      - `organization` Organization, required
        - `id` string, required
        - `name` string, required
        - `classification` string, required
      - `description` string, required
      - `date` string, required
      - `classification` string[], required
      - `order` integer, required
      - `related_entities` BillActionRelatedEntity[]
        - `name` string, required
        - `entity_type` string, required
        - `organization` Organization
          - `id` string, required
          - `name` string, required
          - `classification` string, required
        - `person` CompactPerson
          - `id` string, required
          - `name` string, required
          - `party` string, required
          - `current_role` CurrentRole
            - `title` string, required
            - `org_classification` 'legislature' | 'executive' | 'lower' | 'upper' | 'government', required — An enumeration.
            - `district` union
              - …
            - `division_id` string
    - `sources` Link[]
      - `url` string, required
      - `note` string
    - `versions` BillDocumentOrVersion[]
      - `id` string, uuid, required
      - `note` string, required
      - `date` string, required
      - `classification` string, required
      - `links` BillDocumentLink[], required
        - `url` string, required
        - `media_type` string, required
    - `documents` BillDocumentOrVersion[]
      - `id` string, uuid, required
      - `note` string, required
      - `date` string, required
      - `classification` string, required
      - `links` BillDocumentLink[], required
        - `url` string, required
        - `media_type` string, required
    - `votes` VoteEvent[]
      - `id` string, required
      - `motion_text` string, required
      - `motion_classification` string[]
      - `start_date` string, required
      - `result` string, required
      - `identifier` string, required
      - `extras` object, required
      - `organization` Organization, required
        - `id` string, required
        - `name` string, required
        - `classification` string, required
      - `votes` PersonVote[], required
        - `id` string, uuid, required
        - `option` string, required
        - `voter_name` string, required
        - `voter` CompactPerson
          - `id` string, required
          - `name` string, required
          - `party` string, required
          - `current_role` CurrentRole
            - `title` string, required
            - `org_classification` 'legislature' | 'executive' | 'lower' | 'upper' | 'government', required — An enumeration.
            - `district` union
              - …
            - `division_id` string
      - `counts` VoteCount[], required
        - `option` string, required
        - `value` integer, required
      - `sources` Link[], required
        - `url` string, required
        - `note` string
  - `pagination` PaginationMeta, required
    - `per_page` integer, required
    - `page` integer, required
    - `max_page` integer, required
    - `total_items` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/openstates/apis/open-states-api-v3.md) · [All operations](https://skmtc.dev/openstates/apis/open-states-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openstates/open-states-api-v3/revisions/6d7f86636f9d/schema)