Search bills, legislators, committees, and events across all 50 US states, DC, and 5 US territories.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Fetch full detail for a specific state bill. Accepts either the three-part path (jurisdiction + session + bill_id) or a direct OCD bill ID (openstates_id from search results). Use include to request votes, actions, sponsorships, documents, and versions in one call rather than searching again. include=votes returns the full vote tally and per-legislator positions. include=actions returns the complete action history. Prefer openstates_id when available to avoid session identifier lookup.
Bill identifier as used by the legislature (e.g., "HB 1000", "SB 42"). Required with jurisdiction + session.
Related data to inline. "sponsorships", "actions", "votes" are most commonly needed. "versions" and "documents" provide links to bill text and fiscal notes.
Session identifier. Required with jurisdiction + bill_id.
State name, abbreviation, or OCD-ID. Required when using path-based lookup with session + bill_id.
OCD bill ID from openstates_search_bills results (e.g., "ocd-bill/..."). Preferred over the three-part path when available.
Fetch full detail for a specific state bill. Accepts either the three-part path (jurisdiction + session + bill_id) or a direct OCD bill ID (openstates_id from search results). Use include to request votes, actions, sponsorships, documents, and versions in one call rather than searching again. include=votes returns the full vote tally and per-legislator positions. include=actions returns the complete action history. Prefer openstates_id when available to avoid session identifier lookup.
| Argument | Type | Description |
|---|---|---|
| bill_id | string | Bill identifier as used by the legislature (e.g., "HB 1000", "SB 42"). Required with jurisdiction + session. |
| include | array | Related data to inline. "sponsorships", "actions", "votes" are most commonly needed. "versions" and "documents" provide links to bill text and fiscal notes. |
| session | string | Session identifier. Required with jurisdiction + bill_id. |
| jurisdiction | string | State name, abbreviation, or OCD-ID. Required when using path-based lookup with session + bill_id. |
| openstates_id | string | OCD bill ID from openstates_search_bills results (e.g., "ocd-bill/..."). Preferred over the three-part path when available. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"bill_id": {
"type": "string",
"description": "Bill identifier as used by the legislature (e.g., \"HB 1000\", \"SB 42\"). Required with jurisdiction + session."
},
"include": {
"type": "array",
"items": {
"enum": [
"sponsorships",
"abstracts",
"other_titles",
"other_identifiers",
"actions",
"sources",
"documents",
"versions",
"votes",
"related_bills"
],
"type": "string"
},
"description": "Related data to inline. \"sponsorships\", \"actions\", \"votes\" are most commonly needed. \"versions\" and \"documents\" provide links to bill text and fiscal notes."
},
"session": {
"type": "string",
"description": "Session identifier. Required with jurisdiction + bill_id."
},
"jurisdiction": {
"type": "string",
"description": "State name, abbreviation, or OCD-ID. Required when using path-based lookup with session + bill_id."
},
"openstates_id": {
"type": "string",
"description": "OCD bill ID from openstates_search_bills results (e.g., \"ocd-bill/...\"). Preferred over the three-part path when available."
}
},
"additionalProperties": false
}Fetch committee detail by OCD organization ID. Returns name, classification, and membership roster when include=memberships is requested. Experimental — not all states have committee data in Open States. Obtain the committee_id from openstates_search_committees.
| Argument | Type | Description |
|---|---|---|
| include | array | Related data to inline. "memberships" includes the full roster with member roles. "links" includes the committee homepage and reference links, and "sources" the provenance URLs behind the record. |
| committee_id* | string | OCD organization ID (from openstates_search_committees results). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"committee_id"
],
"properties": {
"include": {
"type": "array",
"items": {
"enum": [
"memberships",
"links",
"sources"
],
"type": "string"
},
"description": "Related data to inline. \"memberships\" includes the full roster with member roles. \"links\" includes the committee homepage and reference links, and \"sources\" the provenance URLs behind the record."
},
"committee_id": {
"type": "string",
"minLength": 1,
"description": "OCD organization ID (from openstates_search_committees results)."
}
},
"additionalProperties": false
}Fetch full event detail by OCD event ID. Returns agenda, participants, media links, and associated documents when requested via include. Experimental — event coverage is limited in Open States. Obtain the event_id from openstates_search_events.
| Argument | Type | Description |
|---|---|---|
| include | array | Related data to inline. "agenda" and "participants" are most useful; "links", "media", and "documents" add related URLs, recordings, and files, and "sources" the provenance URLs behind the record. |
| event_id* | string | OCD event ID (from openstates_search_events results). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"event_id"
],
"properties": {
"include": {
"type": "array",
"items": {
"enum": [
"links",
"sources",
"media",
"documents",
"participants",
"agenda"
],
"type": "string"
},
"description": "Related data to inline. \"agenda\" and \"participants\" are most useful; \"links\", \"media\", and \"documents\" add related URLs, recordings, and files, and \"sources\" the provenance URLs behind the record."
},
"event_id": {
"type": "string",
"minLength": 1,
"description": "OCD event ID (from openstates_search_events results)."
}
},
"additionalProperties": false
}Fetch full metadata for a specific jurisdiction including all legislative sessions, their identifiers, and coverage dates. Use when you need to know the exact session identifier for a state before filtering bill searches — session formats vary widely (e.g., "2025", "2025rs", "2025s1"). Jurisdiction IDs follow OCD format: ocd-jurisdiction/country:us/state:{abbr}/government (e.g., ocd-jurisdiction/country:us/state:wa/government). State names (e.g., "Washington") and two-letter abbreviations (e.g., "wa") are also accepted.
| Argument | Type | Description |
|---|---|---|
| include | array | Related data to inline. "legislative_sessions" returns all historical and current sessions with identifiers and date ranges. "organizations" lists the jurisdiction's legislative chambers and executive bodies. "latest_runs" shows last scraper run metadata. |
| jurisdiction_id* | string | OCD jurisdiction ID, state name (e.g., "Washington"), or two-letter abbreviation (e.g., "wa"). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"jurisdiction_id"
],
"properties": {
"include": {
"type": "array",
"items": {
"enum": [
"organizations",
"legislative_sessions",
"latest_runs"
],
"type": "string"
},
"description": "Related data to inline. \"legislative_sessions\" returns all historical and current sessions with identifiers and date ranges. \"organizations\" lists the jurisdiction's legislative chambers and executive bodies. \"latest_runs\" shows last scraper run metadata."
},
"jurisdiction_id": {
"type": "string",
"minLength": 1,
"description": "OCD jurisdiction ID, state name (e.g., \"Washington\"), or two-letter abbreviation (e.g., \"wa\")."
}
},
"additionalProperties": false
}Find every legislator representing a geographic coordinate — both tiers. Pass latitude and longitude to get the state senators and representatives for that location (and potentially governor/executive officials), plus the coordinate's two US Senators and its US Representative. jurisdiction.classification separates the tiers: "state" is a state legislature, "country" is the US Congress. current_role.org_classification does not — it is "upper"/"lower" for a US Senator exactly as for a state senator. Useful for constituent-to-representative matching, address-based policy research, and electoral boundary analysis. This server does not geocode addresses — the caller must provide decimal-degree coordinates. Use include=offices to get contact information alongside the legislator list.
| Argument | Type | Description |
|---|---|---|
| include | array | Related data to inline. "offices" includes phone, fax, and address. "links" includes website and social links. "other_names" includes alternate/former names, "other_identifiers" cross-system IDs, and "sources" the provenance URLs behind the record. |
| latitude* | number | Latitude in decimal degrees (e.g., 47.6062 for Seattle, WA). |
| longitude* | number | Longitude in decimal degrees (e.g., -122.3321 for Seattle, WA). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"latitude",
"longitude"
],
"properties": {
"include": {
"type": "array",
"items": {
"enum": [
"other_names",
"other_identifiers",
"links",
"sources",
"offices"
],
"type": "string"
},
"description": "Related data to inline. \"offices\" includes phone, fax, and address. \"links\" includes website and social links. \"other_names\" includes alternate/former names, \"other_identifiers\" cross-system IDs, and \"sources\" the provenance URLs behind the record."
},
"latitude": {
"type": "number",
"description": "Latitude in decimal degrees (e.g., 47.6062 for Seattle, WA)."
},
"longitude": {
"type": "number",
"description": "Longitude in decimal degrees (e.g., -122.3321 for Seattle, WA)."
}
},
"additionalProperties": false
}List all jurisdictions covered by Open States — all 50 states, DC, and 5 US territories (American Samoa, Guam, Northern Mariana Islands, Puerto Rico, and the US Virgin Islands): 56 in total, returned complete in a single default call. Returns coverage metadata: latest bill update time, latest people update time, and optionally all legislative sessions with their identifiers. Use this when you need to discover valid session identifiers for a state before calling openstates_search_bills with a session filter. The legislative_sessions include option returns all historical and current sessions — always check valid session identifiers here before using them in bill searches, since formats vary widely by state (e.g., "2025", "2025-2026", "2025rs", "2025s1").
| Argument | Type | Description |
|---|---|---|
| page | integer | Page number (1-indexed). |
| include | array | Related data to inline. "legislative_sessions" returns all session identifiers and date ranges — required when you need to discover valid session values for bill searches. "organizations" lists the jurisdiction's legislative chambers and executive bodies, and "latest_runs" the recent scraper run history. |
| per_page | integer | Results per page (upstream maximum 52). The default call returns the complete state inventory (56) in one response by fetching and merging the pages server-side; set a smaller value only to page manually. |
| classification | string | Filter by jurisdiction type. Use "state" (default) for all 50 states, DC, and the 5 US territories. |
Search state legislative bills across all covered US jurisdictions. Supports full-text search, jurisdiction/session filtering, subject tags, sponsor lookups, and sort order. Either jurisdiction or q (full-text) is required, and pairing them is the reliable form — a q-only search spans all 56 jurisdictions and exceeds the upstream timeout for a common term, though a distinctive one still returns quickly. include=sponsorships,actions returns sponsor and action history inline. sort=latest_action_desc surfaces bills currently moving. openstates_get_jurisdiction with include=legislative_sessions returns valid session identifiers for session filtering.
| Argument | Type | Description |
|---|---|---|
| q | string | Full-text search across bill titles, abstracts, and text. Required unless jurisdiction is provided. Pair it with jurisdiction whenever a state is known — a q-only search over every jurisdiction times out upstream for a common term. |
| page | integer | Page number (1-indexed). |
| sort | string | Sort order. Use "latest_action_desc" for bills currently moving through the legislature. |
| chamber | string | Filter by originating chamber. "upper" = Senate, "lower" = House/Assembly. |
| include | array | Related data to inline. "sponsorships" and "actions" cover most research needs without a separate openstates_get_bill call. "votes" adds full vote tallies and per-legislator positions. |
List committees for a jurisdiction. jurisdiction is required — a request spanning all 56 jurisdictions exceeds the upstream timeout, so scope every call to a single state; use openstates_list_jurisdictions to pick one. Experimental — Open States is actively working to restore committee support and not all states have data. Use chamber to scope to upper (senate) or lower (house) committees. Use classification=subcommittee to find subcommittees of a parent. Use include=memberships to get the full roster with member roles. The coverageNote field in the output will always note the experimental coverage limitations.
| Argument | Type | Description |
|---|---|---|
| page | integer | Page number (1-indexed). |
| parent | string | OCD organization ID of a parent committee to retrieve its subcommittees. |
| chamber | string | Filter by chamber. "upper" = Senate, "lower" = House/Assembly. |
| include | array | Related data to inline. "memberships" includes the full roster with member roles. "links" includes the committee homepage and reference links, and "sources" the provenance URLs behind the record. |
| per_page | integer | Results per page. Maximum 20. |
| jurisdiction* | string | State name, abbreviation, or OCD-ID. Required — an all-states request exceeds the upstream timeout, so every call must be scoped to a single jurisdiction. |
Search hearings, floor sessions, and committee meetings. jurisdiction is required — the Open States events endpoint has no all-states search, so scope every call to a single state; use openstates_list_jurisdictions to pick one. Experimental — most states do not publish event data to Open States. Use after and before to scope to a date range. Set require_bills=true to filter to events with bills on the agenda, which is the most useful filter for tracking legislation through committee. Use include=agenda,participants for full meeting context. Empty results often indicate the state lacks event data rather than no events occurring.
| Argument | Type | Description |
|---|---|---|
| page | integer | Page number (1-indexed). |
| after | string | ISO 8601 datetime — events starting after this time. Use to find upcoming hearings. |
| before | string | ISO 8601 datetime — events starting before this time. |
| include | array | Related data to inline. "agenda" includes the meeting agenda with bill references. "participants" includes the committee or chamber hosting the event. "links" and "media" add related URLs and recordings, "documents" the attached files, and "sources" the provenance URLs behind the record. |
| per_page | integer | Results per page. Maximum 20. |
| jurisdiction* | string |
Search state legislators and officials by name, jurisdiction, chamber, or district, or fetch specific people by OCD person ID. Party is reported on every result but cannot be filtered on — narrow by party after the call. Either jurisdiction or id is required — a search spanning all 56 jurisdictions exceeds the upstream timeout, including a name-only one, so scope every call to a single state or to specific person IDs. Use openstates_list_jurisdictions to pick a jurisdiction, or openstates_get_legislators_by_location when you have coordinates but no state. id takes the person IDs that openstates_get_bill sponsorships and openstates_get_committee memberships hand back, and resolves any number of them in one call. Supports name substring matching (case-insensitive). org_classification targets a role type: "upper" for Senate, "lower" for House/Assembly, "executive" for governors and executive officials, and "legislature" for every legislator — both chambers merged into one paginated set (all upper members, then all lower), which excludes executive-branch officials. Omitting org_classification is not the same as "legislature": it returns every officeholder, executive officials included. include=offices adds phone, fax, and address. include=links adds website and social links.
| Argument | Type | Description |
|---|---|---|
| id | array | OCD person IDs (e.g., "ocd-person/9eddb3cd-868e-42ba-831a-b415fd7ed445"). Required unless jurisdiction is provided — it returns exactly these people, so it scopes the call on its own and needs no jurisdiction alongside it. Resolves the IDs that openstates_search_people results, openstates_get_bill sponsorships[].person.id, and openstates_get_committee memberships[].person_id hand back — any number of them in one call, subject to per_page. An ID Open States does not know matches nothing rather than failing, as does an ID paired with a jurisdiction that person does not belong to. |
| name | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"default": 1,
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number (1-indexed)."
},
"include": {
"type": "array",
"items": {
"enum": [
"organizations",
"legislative_sessions",
"latest_runs"
],
"type": "string"
},
"description": "Related data to inline. \"legislative_sessions\" returns all session identifiers and date ranges — required when you need to discover valid session values for bill searches. \"organizations\" lists the jurisdiction's legislative chambers and executive bodies, and \"latest_runs\" the recent scraper run history."
},
"per_page": {
"type": "integer",
"default": 52,
"maximum": 52,
"minimum": 1,
"description": "Results per page (upstream maximum 52). The default call returns the complete state inventory (56) in one response by fetching and merging the pages server-side; set a smaller value only to page manually."
},
"classification": {
"enum": [
"state",
"municipality",
"country"
],
"type": "string",
"default": "state",
"description": "Filter by jurisdiction type. Use \"state\" (default) for all 50 states, DC, and the 5 US territories."
}
},
"additionalProperties": false
}| session |
| string |
| Session identifier (e.g., "2025", "2025-2026", "2025rs"). Use openstates_get_jurisdiction with include=legislative_sessions to discover valid values. Omit to search across all sessions. |
| sponsor | string | Filter by sponsor name or OCD person ID. |
| subject | array | Filter to bills tagged with one or more subject categories. |
| per_page | integer | Results per page. Maximum 20. Default 10. |
| action_since | string | ISO 8601 date — only return bills with an action after this date (e.g., "2025-01-01"). |
| jurisdiction | string | State name, two-letter abbreviation, or OCD-ID (e.g., "Washington", "wa", or "ocd-jurisdiction/country:us/state:wa/government"). Required unless q is provided. |
| created_since | string | ISO 8601 date — only return bills first entered in Open States after this date (e.g., "2025-01-01"). Use to find newly-introduced bills, as opposed to recently-updated or recently-acted-on. |
| updated_since | string | ISO 8601 date — only return bills updated after this date (e.g., "2025-01-01"). |
| classification | string | Bill classification: "bill", "resolution", "constitutional amendment", etc. |
| sponsor_classification | string | Filter sponsor type: "primary", "cosponsor". |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"q": {
"type": "string",
"minLength": 1,
"description": "Full-text search across bill titles, abstracts, and text. Required unless jurisdiction is provided. Pair it with jurisdiction whenever a state is known — a q-only search over every jurisdiction times out upstream for a common term."
},
"page": {
"type": "integer",
"default": 1,
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number (1-indexed)."
},
"sort": {
"enum": [
"updated_asc",
"updated_desc",
"first_action_asc",
"first_action_desc",
"latest_action_asc",
"latest_action_desc"
],
"type": "string",
"default": "updated_desc",
"description": "Sort order. Use \"latest_action_desc\" for bills currently moving through the legislature."
},
"chamber": {
"enum": [
"upper",
"lower"
],
"type": "string",
"description": "Filter by originating chamber. \"upper\" = Senate, \"lower\" = House/Assembly."
},
"include": {
"type": "array",
"items": {
"enum": [
"sponsorships",
"abstracts",
"other_titles",
"other_identifiers",
"actions",
"sources",
"documents",
"versions",
"votes",
"related_bills"
],
"type": "string"
},
"description": "Related data to inline. \"sponsorships\" and \"actions\" cover most research needs without a separate openstates_get_bill call. \"votes\" adds full vote tallies and per-legislator positions."
},
"session": {
"type": "string",
"description": "Session identifier (e.g., \"2025\", \"2025-2026\", \"2025rs\"). Use openstates_get_jurisdiction with include=legislative_sessions to discover valid values. Omit to search across all sessions."
},
"sponsor": {
"type": "string",
"description": "Filter by sponsor name or OCD person ID."
},
"subject": {
"type": "array",
"items": {
"type": "string"
},
"description": "Filter to bills tagged with one or more subject categories."
},
"per_page": {
"type": "integer",
"default": 10,
"maximum": 20,
"minimum": 1,
"description": "Results per page. Maximum 20. Default 10."
},
"action_since": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(T[\\d:.Z+-]+)?$",
"description": "ISO 8601 date — only return bills with an action after this date (e.g., \"2025-01-01\")."
},
"jurisdiction": {
"type": "string",
"minLength": 1,
"description": "State name, two-letter abbreviation, or OCD-ID (e.g., \"Washington\", \"wa\", or \"ocd-jurisdiction/country:us/state:wa/government\"). Required unless q is provided."
},
"created_since": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(T[\\d:.Z+-]+)?$",
"description": "ISO 8601 date — only return bills first entered in Open States after this date (e.g., \"2025-01-01\"). Use to find newly-introduced bills, as opposed to recently-updated or recently-acted-on."
},
"updated_since": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(T[\\d:.Z+-]+)?$",
"description": "ISO 8601 date — only return bills updated after this date (e.g., \"2025-01-01\")."
},
"classification": {
"type": "string",
"description": "Bill classification: \"bill\", \"resolution\", \"constitutional amendment\", etc."
},
"sponsor_classification": {
"type": "string",
"description": "Filter sponsor type: \"primary\", \"cosponsor\"."
}
},
"additionalProperties": false
}| classification | string | Filter to parent committees or subcommittees only. Omit for all. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"jurisdiction"
],
"properties": {
"page": {
"type": "integer",
"default": 1,
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number (1-indexed)."
},
"parent": {
"type": "string",
"description": "OCD organization ID of a parent committee to retrieve its subcommittees."
},
"chamber": {
"enum": [
"upper",
"lower"
],
"type": "string",
"description": "Filter by chamber. \"upper\" = Senate, \"lower\" = House/Assembly."
},
"include": {
"type": "array",
"items": {
"enum": [
"memberships",
"links",
"sources"
],
"type": "string"
},
"description": "Related data to inline. \"memberships\" includes the full roster with member roles. \"links\" includes the committee homepage and reference links, and \"sources\" the provenance URLs behind the record."
},
"per_page": {
"type": "integer",
"default": 10,
"maximum": 20,
"minimum": 1,
"description": "Results per page. Maximum 20."
},
"jurisdiction": {
"type": "string",
"minLength": 1,
"description": "State name, abbreviation, or OCD-ID. Required — an all-states request exceeds the upstream timeout, so every call must be scoped to a single jurisdiction."
},
"classification": {
"enum": [
"committee",
"subcommittee"
],
"type": "string",
"description": "Filter to parent committees or subcommittees only. Omit for all."
}
},
"additionalProperties": false
}| State name, abbreviation, or OCD-ID. Required — the Open States events endpoint has no all-states search, so every call must be scoped to a single jurisdiction. |
| require_bills | boolean | When true, only return events with at least one bill on the agenda. Most useful for tracking legislation through committee. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"jurisdiction"
],
"properties": {
"page": {
"type": "integer",
"default": 1,
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number (1-indexed)."
},
"after": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(T[\\d:.Z+-]+)?$",
"description": "ISO 8601 datetime — events starting after this time. Use to find upcoming hearings."
},
"before": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(T[\\d:.Z+-]+)?$",
"description": "ISO 8601 datetime — events starting before this time."
},
"include": {
"type": "array",
"items": {
"enum": [
"links",
"sources",
"media",
"documents",
"participants",
"agenda"
],
"type": "string"
},
"description": "Related data to inline. \"agenda\" includes the meeting agenda with bill references. \"participants\" includes the committee or chamber hosting the event. \"links\" and \"media\" add related URLs and recordings, \"documents\" the attached files, and \"sources\" the provenance URLs behind the record."
},
"per_page": {
"type": "integer",
"default": 10,
"maximum": 20,
"minimum": 1,
"description": "Results per page. Maximum 20."
},
"jurisdiction": {
"type": "string",
"minLength": 1,
"description": "State name, abbreviation, or OCD-ID. Required — the Open States events endpoint has no all-states search, so every call must be scoped to a single jurisdiction."
},
"require_bills": {
"type": "boolean",
"default": false,
"description": "When true, only return events with at least one bill on the agenda. Most useful for tracking legislation through committee."
}
},
"additionalProperties": false
}| Name or partial name to match (case-insensitive substring). Narrows within the jurisdiction; it does not substitute for one. |
| page | integer | Page number (1-indexed). |
| include | array | Related data to inline. "offices" includes phone, fax, and address. "links" includes website and social links. "other_names" includes alternate/former names, "other_identifiers" cross-system IDs, and "sources" the provenance URLs behind the record. |
| district | string | District label (e.g., "1", "37", "At-Large"). Formats vary by state. |
| per_page | integer | Results per page. Maximum 20. |
| jurisdiction | string | State name, abbreviation, or OCD-ID. Required unless id is provided — an all-states search exceeds the upstream timeout, so every call must be scoped to a single jurisdiction or to specific person IDs. |
| org_classification | string | Filter by role type. "upper" = Senate, "lower" = House/Assembly, "executive" = governors and executive officials, "legislature" = every legislator (both chambers merged into one paginated set, all upper members then all lower, excluding executive officials). Omitting this filter returns every officeholder including executive ones — it is not equivalent to "legislature". |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"minItems": 1,
"description": "OCD person IDs (e.g., \"ocd-person/9eddb3cd-868e-42ba-831a-b415fd7ed445\"). Required unless jurisdiction is provided — it returns exactly these people, so it scopes the call on its own and needs no jurisdiction alongside it. Resolves the IDs that openstates_search_people results, openstates_get_bill sponsorships[].person.id, and openstates_get_committee memberships[].person_id hand back — any number of them in one call, subject to per_page. An ID Open States does not know matches nothing rather than failing, as does an ID paired with a jurisdiction that person does not belong to."
},
"name": {
"type": "string",
"description": "Name or partial name to match (case-insensitive substring). Narrows within the jurisdiction; it does not substitute for one."
},
"page": {
"type": "integer",
"default": 1,
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number (1-indexed)."
},
"include": {
"type": "array",
"items": {
"enum": [
"other_names",
"other_identifiers",
"links",
"sources",
"offices"
],
"type": "string"
},
"description": "Related data to inline. \"offices\" includes phone, fax, and address. \"links\" includes website and social links. \"other_names\" includes alternate/former names, \"other_identifiers\" cross-system IDs, and \"sources\" the provenance URLs behind the record."
},
"district": {
"type": "string",
"description": "District label (e.g., \"1\", \"37\", \"At-Large\"). Formats vary by state."
},
"per_page": {
"type": "integer",
"default": 10,
"maximum": 20,
"minimum": 1,
"description": "Results per page. Maximum 20."
},
"jurisdiction": {
"type": "string",
"minLength": 1,
"description": "State name, abbreviation, or OCD-ID. Required unless id is provided — an all-states search exceeds the upstream timeout, so every call must be scoped to a single jurisdiction or to specific person IDs."
},
"org_classification": {
"enum": [
"legislature",
"executive",
"lower",
"upper",
"government"
],
"type": "string",
"description": "Filter by role type. \"upper\" = Senate, \"lower\" = House/Assembly, \"executive\" = governors and executive officials, \"legislature\" = every legislator (both chambers merged into one paginated set, all upper members then all lower, excluding executive officials). Omitting this filter returns every officeholder including executive ones — it is not equivalent to \"legislature\"."
}
},
"additionalProperties": false
}