API v1 is deprecated, please check out API v3 or API v2 both of which are actively supported.

As of November 2018 we are beginning the process of removing lesser-used portions of this API. New applications should use API v2 or v3.

None of these were used by more than 1% of API users, and their removal will help us hopefully extend the life of the existing API.

The Event & Committee endpoints are no longer supported. Committees are available in API v2, and events are not currently collected as part of Open States.

Additionally, the boundary endpoint will no longer be something we provide. This data changes rarely and is best served from a static resource instead of an HTTP query. We are exploring options to provide a suitable resource for this in the future.

Additionally, the following rarely-used parameters are no longer supported in v1, similar functionality is available in v2:

Bill Search: sponsor_id

subject

type

bill_id__in

sort=signed, sort=passed_upper, sort=passed_lower Legislator Search: first_name

last_name

active=false

party

term

If you were using the fields= parameter to control which data was returned you’ll find that it is no longer always respected. To ease caching we have altered the behavior, this was designed to be done in a backwards-compatible way: we now return more fields than we used to by default, and only in select cases is it necessary to add fields= to a request to obtain fields that would otherwise be omitted.

Additionally, the extra fields prefixed with + are scheduled to be removed. They were never guaranteed, and we presume this won’t affect any users.