---
title: "Bill Detail By Id"
method: GET
path: "/bills/ocd-bill/{openstates_bill_id}"
tags: ["bills"]
---

# Bill Detail By Id

`GET /bills/ocd-bill/{openstates_bill_id}`

## Request

- Base URL: `https://v3.openstates.org` (the document declares no server; this is the origin it was published from)
- URL: `https://v3.openstates.org/bills/ocd-bill/{openstates_bill_id}`
- Auth: none declared

Obtain bill information by internal ID in the format ocd-bill/*uuid*.

## Path parameters

- `openstates_bill_id` string, required

## Query parameters

- `include` BillInclude[]
- `apikey` string

## Headers

- `x-api-key` string

## Response `200`

Successful Response

- Bill
  - `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
            - string
            - integer
          - `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
            - string
            - integer
          - `division_id` string
    - `counts` VoteCount[], required
      - `option` string, required
      - `value` integer, required
    - `sources` Link[], required
      - `url` string, required
      - `note` string

## 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.dev/openstates/apis/open-states-api-v3/revisions/6d7f86636f9d?raw)
