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-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: [email protected]
  - 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/
    contact:
      - FN: Open States Support
        email: [email protected]
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: [email protected]