Open States API v3

openstates · Data

Data No Auth Free & Open open_data

* [More documentation](https://docs.openstates.org/en/latest/api/v3/index.html) * [Register for an account](https://openstates.org/accounts/signup/) **We are currently working to restore experimental support for committees & events.** During this period please note that data is not yet available for all states and the exact format of the new endpoints may change slightly depending on user feedback. If you have any issues or questions use our [GitHub Issues](https://github.com/openstates/iss

Authentication

No authentication requiredFree to use with no key needed.

Sample Requests

GET Bills Search

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

https://api.apis.guru/v2/specs/openstates.org/2021.11.12/bills?q=test&page=1&sort=updated_desc&apikey=example&chamber=example&include=&session=example&sponsor=example&subject=&per_page=10&identifier=&action_since=example&jurisdiction=example&created_since=example&updated_since=example&classification=example&sponsor_classification=example

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/openstates.org/2021.11.12/bills?q=test&page=1&sort=updated_desc&apikey=example&chamber=example&include=&session=example&sponsor=example&subject=&per_page=10&identifier=&action_since=example&jurisdiction=example&created_since=example&updated_since=example&classification=example&sponsor_classification=example"

import requests
params = {
    "q": "test",
    "page": "1",
    "sort": "updated_desc",
    "apikey": "example",
    "chamber": "example",
    "include": "",
    "session": "example",
    "sponsor": "example",
    "subject": "",
    "per_page": "10",
    "identifier": "",
    "action_since": "example",
    "jurisdiction": "example",
    "created_since": "example",
    "updated_since": "example",
    "classification": "example",
    "sponsor_classification": "example"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/openstates.org/2021.11.12/bills",
    params=params,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/openstates.org/2021.11.12/bills');
url.searchParams.set('q', 'test');
url.searchParams.set('page', '1');
url.searchParams.set('sort', 'updated_desc');
url.searchParams.set('apikey', 'example');
url.searchParams.set('chamber', 'example');
url.searchParams.set('include', '');
url.searchParams.set('session', 'example');
url.searchParams.set('sponsor', 'example');
url.searchParams.set('subject', '');
url.searchParams.set('per_page', '10');
url.searchParams.set('identifier', '');
url.searchParams.set('action_since', 'example');
url.searchParams.set('jurisdiction', 'example');
url.searchParams.set('created_since', 'example');
url.searchParams.set('updated_since', 'example');
url.searchParams.set('classification', 'example');
url.searchParams.set('sponsor_classification', 'example');

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/openstates.org/2021.11.12/bills")
	q := baseURL.Query()
	q.Set("q", "test")
	q.Set("page", "1")
	q.Set("sort", "updated_desc")
	q.Set("apikey", "example")
	q.Set("chamber", "example")
	q.Set("include", "")
	q.Set("session", "example")
	q.Set("sponsor", "example")
	q.Set("subject", "")
	q.Set("per_page", "10")
	q.Set("identifier", "")
	q.Set("action_since", "example")
	q.Set("jurisdiction", "example")
	q.Set("created_since", "example")
	q.Set("updated_since", "example")
	q.Set("classification", "example")
	q.Set("sponsor_classification", "example")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/openstates.org/2021.11.12/bills")
uri.query = URI.encode_www_form({
  "q" => "test",
  "page" => "1",
  "sort" => "updated_desc",
  "apikey" => "example",
  "chamber" => "example",
  "include" => "",
  "session" => "example",
  "sponsor" => "example",
  "subject" => "",
  "per_page" => "10",
  "identifier" => "",
  "action_since" => "example",
  "jurisdiction" => "example",
  "created_since" => "example",
  "updated_since" => "example",
  "classification" => "example",
  "sponsor_classification" => "example"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/openstates.org/2021.11.12/bills?" . http_build_query([
    "q" => "test",
    "page" => "1",
    "sort" => "updated_desc",
    "apikey" => "example",
    "chamber" => "example",
    "include" => "",
    "session" => "example",
    "sponsor" => "example",
    "subject" => "",
    "per_page" => "10",
    "identifier" => "",
    "action_since" => "example",
    "jurisdiction" => "example",
    "created_since" => "example",
    "updated_since" => "example",
    "classification" => "example",
    "sponsor_classification" => "example"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

GET Committee List

Committee List

https://api.apis.guru/v2/specs/openstates.org/2021.11.12/committees?page=1&apikey=example&parent=example&chamber=example&include=&per_page=20&jurisdiction=example&classification=example

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/openstates.org/2021.11.12/committees?page=1&apikey=example&parent=example&chamber=example&include=&per_page=20&jurisdiction=example&classification=example"

import requests
params = {
    "page": "1",
    "apikey": "example",
    "parent": "example",
    "chamber": "example",
    "include": "",
    "per_page": "20",
    "jurisdiction": "example",
    "classification": "example"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/openstates.org/2021.11.12/committees",
    params=params,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/openstates.org/2021.11.12/committees');
url.searchParams.set('page', '1');
url.searchParams.set('apikey', 'example');
url.searchParams.set('parent', 'example');
url.searchParams.set('chamber', 'example');
url.searchParams.set('include', '');
url.searchParams.set('per_page', '20');
url.searchParams.set('jurisdiction', 'example');
url.searchParams.set('classification', 'example');

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/openstates.org/2021.11.12/committees")
	q := baseURL.Query()
	q.Set("page", "1")
	q.Set("apikey", "example")
	q.Set("parent", "example")
	q.Set("chamber", "example")
	q.Set("include", "")
	q.Set("per_page", "20")
	q.Set("jurisdiction", "example")
	q.Set("classification", "example")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/openstates.org/2021.11.12/committees")
uri.query = URI.encode_www_form({
  "page" => "1",
  "apikey" => "example",
  "parent" => "example",
  "chamber" => "example",
  "include" => "",
  "per_page" => "20",
  "jurisdiction" => "example",
  "classification" => "example"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/openstates.org/2021.11.12/committees?" . http_build_query([
    "page" => "1",
    "apikey" => "example",
    "parent" => "example",
    "chamber" => "example",
    "include" => "",
    "per_page" => "20",
    "jurisdiction" => "example",
    "classification" => "example"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

GET Event List

Event List

https://api.apis.guru/v2/specs/openstates.org/2021.11.12/events?page=1&after=example&apikey=example&before=example&deleted=false&include=&per_page=20&jurisdiction=example&require_bills=false

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/openstates.org/2021.11.12/events?page=1&after=example&apikey=example&before=example&deleted=false&include=&per_page=20&jurisdiction=example&require_bills=false"

import requests
params = {
    "page": "1",
    "after": "example",
    "apikey": "example",
    "before": "example",
    "deleted": "false",
    "include": "",
    "per_page": "20",
    "jurisdiction": "example",
    "require_bills": "false"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/openstates.org/2021.11.12/events",
    params=params,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/openstates.org/2021.11.12/events');
url.searchParams.set('page', '1');
url.searchParams.set('after', 'example');
url.searchParams.set('apikey', 'example');
url.searchParams.set('before', 'example');
url.searchParams.set('deleted', 'false');
url.searchParams.set('include', '');
url.searchParams.set('per_page', '20');
url.searchParams.set('jurisdiction', 'example');
url.searchParams.set('require_bills', 'false');

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/openstates.org/2021.11.12/events")
	q := baseURL.Query()
	q.Set("page", "1")
	q.Set("after", "example")
	q.Set("apikey", "example")
	q.Set("before", "example")
	q.Set("deleted", "false")
	q.Set("include", "")
	q.Set("per_page", "20")
	q.Set("jurisdiction", "example")
	q.Set("require_bills", "false")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/openstates.org/2021.11.12/events")
uri.query = URI.encode_www_form({
  "page" => "1",
  "after" => "example",
  "apikey" => "example",
  "before" => "example",
  "deleted" => "false",
  "include" => "",
  "per_page" => "20",
  "jurisdiction" => "example",
  "require_bills" => "false"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/openstates.org/2021.11.12/events?" . http_build_query([
    "page" => "1",
    "after" => "example",
    "apikey" => "example",
    "before" => "example",
    "deleted" => "false",
    "include" => "",
    "per_page" => "20",
    "jurisdiction" => "example",
    "require_bills" => "false"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

Postman Setup Guide

Get Postman ↗

See official documentation for authentication and setup.

What can you build with Open States API v3?

Open States API v3 is a Data API. Developers commonly use data APIs for:

enriching your app with third-party datasets
building data pipelines and ETL workflows
querying and searching large datasets
powering research, analysis, and reporting tools
syncing reference data into your own systems

No authentication required. This API is open — no signup or key needed. Ideal for quick prototypes and public-facing features. Open States API v3 is free to use, making it a low-risk choice to experiment with.

New to APIs? Read our beginner's guide · Learn about API keys · What is REST?

Open documentation ↗