Open States

aid: openstates
name: Open States
description: 'Open States is a civic technology project that aggregates and publishes legislative data for all 50 US states,
  Washington DC, Puerto Rico, and select municipal governments. It provides a REST API (v3) and a deprecated GraphQL API (v2)
  for programmatic access to bill text, sponsors, votes, legislators, committee information, and legislative events. Data
  is also available via bulk downloads. The project is maintained by Plural Policy as open civic infrastructure.

  '
type: Index
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
url: https://raw.githubusercontent.com/api-evangelist/openstates/refs/heads/main/apis.yml
created: '2026-06-13'
modified: '2026-06-13'
specificationVersion: '0.19'
tags:
- Government
- Legislative Data
- Civic Technology
- State Legislature
- Bills
- Legislators
- Committees
- Open Data
- REST
- GraphQL
apis:
- aid: openstates:openstates-api-v3
  name: Open States API v3
  description: 'REST API providing programmatic access to US state legislative data including jurisdictions, legislators,
    bills, committees, and events. Requires an API key obtained from open.pluralpolicy.com. Responses are in JSON. Interactive
    documentation is available via Swagger UI and ReDoc.

    '
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://docs.openstates.org/api-v3/
  baseURL: https://v3.openstates.org/
  tags:
  - Legislative Data
  - Bills
  - Legislators
  - Committees
  - Events
  - REST
  - Government
  properties:
  - type: Documentation
    url: https://docs.openstates.org/api-v3/
  - type: OpenAPI
    url: https://v3.openstates.org/openapi.json
  - type: SwaggerUI
    url: https://v3.openstates.org/docs/
  - type: ReDoc
    url: https://v3.openstates.org/redoc/
  - type: GitHubRepository
    url: https://github.com/openstates/api-v3
  contact:
  - FN: Open States Support
    email: contact@openstates.org
- aid: openstates:openstates-graphql-api
  name: Open States GraphQL API (v2 - Deprecated)
  description: 'Legacy GraphQL API providing access to Open States legislative data. This API has been deprecated in favour
    of API v3. Existing integrations should migrate to the REST v3 API.

    '
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://docs.openstates.org/graphql/
  baseURL: https://openstates.org/graphql/
  tags:
  - GraphQL
  - Deprecated
  - Legislative Data
  properties:
  - type: Documentation
    url: https://docs.openstates.org/graphql/
  - url: graphql/openstates-graphql.md
    type: GraphQL
  - url: graphql/openstates-schema.graphql
    type: GraphQLSchema
  contact:
  - FN: Open States Support
    email: contact@openstates.org
common:
- type: Website
  url: https://pluralpolicy.com/open
- type: Documentation
  url: https://docs.openstates.org/
- type: GitHubOrg
  url: https://github.com/openstates
- type: Blog
  url: https://blog.openstates.org/
- type: Pricing
  url: https://open.pluralpolicy.com/accounts/profile/
- type: X
  url: https://twitter.com/openstates
- type: Plans
  url: plans/openstates-plans-pricing.yml
- type: RateLimits
  url: rate-limits/openstates-rate-limits.yml
- type: FinOps
  url: finops/openstates-finops.yml
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com