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-productions.s3.amazonaws.com/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-productions.s3.amazonaws.com/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-productions.s3.amazonaws.com/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