v1

latestOpenAPI 3.0.22026-07-13125644.4 KB
bills

Bill Detail By Id

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

get/bills/ocd-bill/{openstates_bill_id}

Path parameters

openstates_bill_idstring required

Query parameters

includeBillInclude[]
apikeystring

Headers

x-api-keystring

Response

Successful Response

idstring required
sessionstring required
identifierstring required
titlestring required
classificationstring[]
subjectstring[]
extrasobject
created_atstring date-time required
updated_atstring date-time required
openstates_urlstring required
first_action_datestring
latest_action_datestring
latest_action_descriptionstring
latest_passage_datestring

Example response

{
  "id": "ocd-bill/f0049138-1ad8-4506-a2a4-f4dd1251bbba",
  "session": "2020",
  "jurisdiction": {
    "id": "ocd-jurisdiction/country:us/state:nc/government",
    "name": "North Carolina"
  },
  "from_organization": {
    "id": "ocd-organization/32aab083-d7a0-44e0-9b95-a7790c542605",
    "name": "North Carolina General Assembly",
    "classification": "legislature"
  },
  "identifier": "SB 113",
  "title": "Adopting a State Scorpion",
  "classification": [
    "resolution"
  ],
  "subject": [
    "SCORPIONS",
    "SYMBOLS"
  ],
  "extras": {},
  "openstates_url": "https://openstates.org/nc/bills/2019/HB1105/",
  "first_action_date": "2020-01-01",
  "latest_action_date": "2020-02-01",
  "latest_action_description": "Introduced in House",
  "latest_passage_date": "2020-03-01",
  "related_bills": [
    {
      "identifier": "HB 123",
      "legislative_session": "2022S1",
      "relation_type": "companion"
    }
  ],
  "abstracts": [
    {
      "abstract": "This bill designates a new state arachnid.",
      "note": "house abstract"
    }
  ],
  "other_titles": [
    {
      "title": "Designating the scorpion as the state arachnid.",
      "note": "short title"
    }
  ],
  "other_identifiers": [
    {
      "identifier": "ocd-bill-mn-2025_2026-sf827"
    }
  ],
  "sponsorships": [
    {
      "id": "f0049138-1ad8-4506-a2a4-f4dd1251bbba",
      "name": "JONES",
      "entity_type": "person",
      "organization": {
        "id": "ocd-organization/32aab083-d7a0-44e0-9b95-a7790c542605",
        "name": "North Carolina General Assembly",
        "classification": "legislature"
      },
      "person": {
        "id": "ocd-person/adb58f21-f2fd-4830-85b6-f490b0867d14",
        "name": "Angela Augusta",
        "party": "Democratic",
        "current_role": {
          "title": "Senator",
          "division_id": "ocd-division/country:us/state:nc/sldu:3"
        }
      },
      "classification": "primary"
    }
  ],
  "actions": [
    {
      "id": "f0049138-1ad8-4506-a2a4-f4dd1251bbba",
      "organization": {
        "id": "ocd-organization/32aab083-d7a0-44e0-9b95-a7790c542605",
        "name": "North Carolina General Assembly",
        "classification": "legislature"
      },
      "description": "Passed 1st Reading",
      "date": "2020-03-14",
      "classification": [
        "passed"
      ],
      "related_entities": [
        {
          "name": "Senate Committee of the Whole",
          "entity_type": "organization",
          "organization": {
            "id": "ocd-organization/32aab083-d7a0-44e0-9b95-a7790c542605",
            "name": "North Carolina General Assembly",
            "classification": "legislature"
          },
          "person": {
            "id": "ocd-person/adb58f21-f2fd-4830-85b6-f490b0867d14",
            "name": "Angela Augusta",
            "party": "Democratic",
            "current_role": {
              "title": "Senator",
              "division_id": "ocd-division/country:us/state:nc/sldu:3"
            }
          }
        }
      ]
    }
  ],
  "sources": [
    {
      "url": "https://example.com/",
      "note": "homepage"
    }
  ],
  "versions": [
    {
      "id": "f0049138-1ad8-4506-a2a4-f4dd1251bbba",
      "note": "Latest Version",
      "date": "2020-10-01",
      "classification": "amendment",
      "links": [
        {
          "url": "https://example.com/doc.pdf",
          "media_type": "application/pdf"
        }
      ]
    }
  ],
  "documents": [
    {
      "id": "f0049138-1ad8-4506-a2a4-f4dd1251bbba",
      "note": "Latest Version",
      "date": "2020-10-01",
      "classification": "amendment",
      "links": [
        {
          "url": "https://example.com/doc.pdf",
          "media_type": "application/pdf"
        }
      ]
    }
  ],
  "votes": [
    {
      "motion_text": "Shall the bill be passed?",
      "motion_classification": [
        "passage"
      ],
      "start_date": "2020-09-18",
      "result": "pass",
      "identifier": "HV #3312",
      "organization": {
        "id": "ocd-organization/32aab083-d7a0-44e0-9b95-a7790c542605",
        "name": "North Carolina General Assembly",
        "classification": "legislature"
      },
      "votes": [
        {
          "id": "f0049138-1ad8-4506-a2a4-f4dd1251bbba",
          "option": "no",
          "voter_name": "Wu",
          "voter": {
            "id": "ocd-person/adb58f21-f2fd-4830-85b6-f490b0867d14",
            "name": "Angela Augusta",
            "party": "Democratic",
            "current_role": {
              "title": "Senator",
              "division_id": "ocd-division/country:us/state:nc/sldu:3"
            }
          }
        }
      ],
      "counts": [
        {
          "option": "yes",
          "value": 48
        }
      ],
      "sources": [
        {
          "url": "https://example.com/",
          "note": "homepage"
        }
      ]
    }
  ]
}