Open States jurisdictions API
The jurisdictions API from Open States — 2 operation(s) for jurisdictions.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/openstates-jurisdictions-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Open States API v3 bills Jurisdictions API
description: '
* [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/issues/issues) to give feedback.'
version: 2021.11.12
servers:
- url: https://v3.openstates.org/
description: Base URL declared by the provider in apis.yml (roadmap#122).
tags:
- name: jurisdictions
paths:
/jurisdictions:
get:
tags:
- jurisdictions
summary: Jurisdiction List
description: Get list of supported Jurisdictions, a Jurisdiction is a state or municipality.
operationId: jurisdiction_list_jurisdictions_get
parameters:
- description: Filter returned jurisdictions by type.
required: false
schema:
allOf:
- $ref: '#/components/schemas/JurisdictionClassification'
description: Filter returned jurisdictions by type.
name: classification
in: query
- description: Additional information to include in response.
required: false
schema:
type: array
items:
$ref: '#/components/schemas/JurisdictionInclude'
description: Additional information to include in response.
default: []
name: include
in: query
- required: false
schema:
title: Page
type: integer
default: 1
name: page
in: query
- required: false
schema:
title: Per Page
type: integer
default: 52
name: per_page
in: query
- required: false
schema:
title: Apikey
type: string
name: apikey
in: query
- required: false
schema:
title: X-Api-Key
type: string
name: x-api-key
in: header
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/JurisdictionList'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/jurisdictions/{jurisdiction_id}:
get:
tags:
- jurisdictions
summary: Jurisdiction Detail
description: Get details on a single Jurisdiction (e.g. state or municipality).
operationId: jurisdiction_detail_jurisdictions__jurisdiction_id__get
parameters:
- required: true
schema:
title: Jurisdiction Id
type: string
name: jurisdiction_id
in: path
- description: Additional includes for the Jurisdiction response.
required: false
schema:
type: array
items:
$ref: '#/components/schemas/JurisdictionInclude'
description: Additional includes for the Jurisdiction response.
default: []
name: include
in: query
- required: false
schema:
title: Apikey
type: string
name: apikey
in: query
- required: false
schema:
title: X-Api-Key
type: string
name: x-api-key
in: header
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/Jurisdiction'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
Jurisdiction:
title: Jurisdiction
required:
- id
- name
- classification
- url
- latest_bill_update
- latest_people_update
type: object
properties:
id:
title: Id
type: string
example: ocd-jurisdiction/country:us/state:nc/government
name:
title: Name
type: string
example: North Carolina
classification:
allOf:
- $ref: '#/components/schemas/JurisdictionClassification'
example: state
division_id:
title: Division Id
type: string
default: ''
example: ocd-division/country:us/state:nc
url:
title: Url
type: string
example: https://nc.gov
latest_bill_update:
title: Latest Bill Update
type: string
format: date-time
latest_people_update:
title: Latest People Update
type: string
format: date-time
organizations:
title: Organizations
type: array
items:
$ref: '#/components/schemas/Chamber'
legislative_sessions:
title: Legislative Sessions
type: array
items:
$ref: '#/components/schemas/LegislativeSession'
latest_runs:
title: Latest Runs
type: array
items:
$ref: '#/components/schemas/RunPlan'
LegislativeSession:
title: LegislativeSession
required:
- identifier
- name
- classification
- start_date
- end_date
type: object
properties:
identifier:
title: Identifier
type: string
name:
title: Name
type: string
classification:
title: Classification
type: string
start_date:
title: Start Date
type: string
end_date:
title: End Date
type: string
downloads:
title: Downloads
type: array
items:
$ref: '#/components/schemas/DataExport'
Chamber:
title: Chamber
required:
- id
- name
- classification
type: object
properties:
id:
title: Id
type: string
example: ocd-organization/32aab083-d7a0-44e0-9b95-a7790c542605
name:
title: Name
type: string
example: North Carolina General Assembly
classification:
title: Classification
type: string
example: legislature
districts:
title: Districts
type: array
items:
$ref: '#/components/schemas/Post'
RunPlan:
title: RunPlan
required:
- success
- start_time
- end_time
type: object
properties:
success:
title: Success
type: boolean
start_time:
title: Start Time
type: string
format: date-time
end_time:
title: End Time
type: string
format: date-time
DataExport:
title: DataExport
required:
- created_at
- updated_at
- data_type
- url
type: object
properties:
created_at:
title: Created At
type: string
format: date-time
updated_at:
title: Updated At
type: string
format: date-time
data_type:
title: Data Type
type: string
url:
title: Url
type: string
ValidationError:
title: ValidationError
required:
- loc
- msg
- type
type: object
properties:
loc:
title: Location
type: array
items:
anyOf:
- type: string
- type: integer
msg:
title: Message
type: string
type:
title: Error Type
type: string
JurisdictionInclude:
title: JurisdictionInclude
enum:
- organizations
- legislative_sessions
- latest_runs
type: string
description: An enumeration.
PaginationMeta:
title: PaginationMeta
required:
- per_page
- page
- max_page
- total_items
type: object
properties:
per_page:
title: Per Page
type: integer
example: 20
page:
title: Page
type: integer
example: 1
max_page:
title: Max Page
type: integer
example: 3
total_items:
title: Total Items
type: integer
example: 52
HTTPValidationError:
title: HTTPValidationError
type: object
properties:
detail:
title: Detail
type: array
items:
$ref: '#/components/schemas/ValidationError'
JurisdictionList:
title: JurisdictionList
required:
- results
- pagination
type: object
properties:
results:
title: Results
type: array
items:
$ref: '#/components/schemas/Jurisdiction'
pagination:
$ref: '#/components/schemas/PaginationMeta'
JurisdictionClassification:
title: JurisdictionClassification
enum:
- state
- municipality
- country
type: string
description: An enumeration.
Post:
title: Post
required:
- label
- role
- division_id
- maximum_memberships
type: object
properties:
label:
title: Label
type: string
example: '2'
role:
title: Role
type: string
example: Senator
division_id:
title: Division Id
type: string
example: ocd-division/country:us/state:mn/sldu:4
maximum_memberships:
title: Maximum Memberships
type: integer
example: 1