Open States · Example Payload

Bills Search

Example response from GET /bills?jurisdiction=North+Carolina&session=2023&per_page=2

GovernmentLegislative DataCivic TechnologyState LegislatureBillsLegislatorsCommitteesOpen DataRESTGraphQL

Bills Search is an example object payload from Open States, with 3 top-level fields. It illustrates the shape of data this provider's APIs accept or return.

Top-level fields

descriptionrequestresponse

Example Payload

{
  "description": "Example response from GET /bills?jurisdiction=North+Carolina&session=2023&per_page=2",
  "request": {
    "method": "GET",
    "url": "https://v3.openstates.org/bills",
    "parameters": {
      "jurisdiction": "North Carolina",
      "session": "2023",
      "per_page": 2,
      "include": ["sponsorships", "actions"]
    },
    "headers": {
      "X-Api-Key": "YOUR_API_KEY"
    }
  },
  "response": {
    "status": 200,
    "body": {
      "results": [
        {
          "id": "ocd-bill/f0049138-1ad8-4506-a2a4-f4dd1251bbba",
          "session": "2023",
          "jurisdiction": {
            "id": "ocd-jurisdiction/country:us/state:nc/government",
            "name": "North Carolina",
            "classification": "state"
          },
          "from_organization": {
            "id": "ocd-organization/32aab083-d7a0-44e0-9b95-a7790c542605",
            "name": "North Carolina General Assembly",
            "classification": "legislature"
          },
          "identifier": "HB 1",
          "title": "State Budget Appropriations Act",
          "classification": ["bill"],
          "subject": ["BUDGET", "APPROPRIATIONS"],
          "extras": {},
          "created_at": "2023-01-11T14:00:00Z",
          "updated_at": "2023-06-15T09:30:00Z",
          "openstates_url": "https://openstates.org/nc/bills/2023/HB1/",
          "first_action_date": "2023-01-11",
          "latest_action_date": "2023-06-15",
          "latest_action_description": "Passed 3rd Reading",
          "latest_passage_date": "2023-06-15",
          "sponsorships": [
            {
              "id": "aaaabbbb-0000-1111-2222-ccccddddeeee",
              "name": "Smith",
              "entity_type": "person",
              "primary": true,
              "classification": "primary"
            }
          ],
          "actions": [
            {
              "id": "11112222-3333-4444-5555-666677778888",
              "organization": {
                "id": "ocd-organization/32aab083-d7a0-44e0-9b95-a7790c542605",
                "name": "North Carolina General Assembly",
                "classification": "legislature"
              },
              "description": "Introduced in House",
              "date": "2023-01-11",
              "classification": ["introduction"],
              "order": 1
            }
          ]
        }
      ],
      "pagination": {
        "per_page": 2,
        "page": 1,
        "max_page": 500,
        "total_items": 1000
      }
    }
  }
}