Open States · Schema

Person

A legislator or government official tracked by the Open States API.

GovernmentLegislative DataCivic TechnologyState LegislatureBillsLegislatorsCommitteesOpen DataRESTGraphQL

Properties

Name	Type	Description
id	string	Open Civic Data person identifier.
name	string	Full display name of the legislator.
party	string	Political party affiliation.
current_role	object	Current legislative role.
jurisdiction	object	Jurisdiction the person represents.
given_name	string
family_name	string
image	string	URL to legislator's official photo.
email	string	Official email address.
gender	string
birth_date	string
death_date	string
extras	object
created_at	string
updated_at	string
openstates_url	string	URL to this person's page on openstates.org.
other_identifiers	array
other_names	array
links	array
offices	array

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/openstates/main/json-schema/person.json",
  "title": "Person",
  "description": "A legislator or government official tracked by the Open States API.",
  "type": "object",
  "required": ["id", "name", "party", "jurisdiction", "given_name", "family_name", "image", "email", "gender", "birth_date", "death_date", "extras", "created_at", "updated_at", "openstates_url"],
  "properties": {
    "id": {
      "type": "string",
      "description": "Open Civic Data person identifier.",
      "example": "ocd-person/adb58f21-f2fd-4830-85b6-f490b0867d14"
    },
    "name": {
      "type": "string",
      "description": "Full display name of the legislator.",
      "example": "Angela Augusta"
    },
    "party": {
      "type": "string",
      "description": "Political party affiliation.",
      "example": "Democratic"
    },
    "current_role": {
      "type": "object",
      "description": "Current legislative role.",
      "properties": {
        "title": {"type": "string", "example": "Senator"},
        "org_classification": {"type": "string", "example": "upper"},
        "district": {},
        "division_id": {"type": "string"}
      }
    },
    "jurisdiction": {
      "type": "object",
      "description": "Jurisdiction the person represents.",
      "properties": {
        "id": {"type": "string"},
        "name": {"type": "string"},
        "classification": {"type": "string"}
      }
    },
    "given_name": {"type": "string", "example": "Angela"},
    "family_name": {"type": "string", "example": "Augusta"},
    "image": {"type": "string", "description": "URL to legislator's official photo."},
    "email": {"type": "string", "description": "Official email address."},
    "gender": {"type": "string"},
    "birth_date": {"type": "string", "example": "1960-05-04"},
    "death_date": {"type": "string"},
    "extras": {"type": "object"},
    "created_at": {"type": "string", "format": "date-time"},
    "updated_at": {"type": "string", "format": "date-time"},
    "openstates_url": {"type": "string", "description": "URL to this person's page on openstates.org."},
    "other_identifiers": {
      "type": "array",
      "items": {
        "type": "object",
        "required": ["identifier", "scheme"],
        "properties": {
          "identifier": {"type": "string"},
          "scheme": {"type": "string"}
        }
      }
    },
    "other_names": {
      "type": "array",
      "items": {
        "type": "object",
        "required": ["name", "note"],
        "properties": {
          "name": {"type": "string"},
          "note": {"type": "string"}
        }
      }
    },
    "links": {
      "type": "array",
      "items": {"type": "object", "properties": {"url": {"type": "string"}, "note": {"type": "string"}}}
    },
    "offices": {
      "type": "array",
      "items": {
        "type": "object",
        "required": ["name"],
        "properties": {
          "name": {"type": "string"},
          "fax": {"type": "string"},
          "voice": {"type": "string"},
          "address": {"type": "string"},
          "classification": {"type": "string"}
        }
      }
    }
  }
}

Work with this as data

Every JSON Schema 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 schemas

4 MCP tools reach this

find_json_schemasBrowse and filter every JSON Schema in the catalog.
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.

All 92 tools →

Call it yourself

curl for this page

This JSON Schema

curl "https://apis.io/api/v1/json-schemas/person"

All schemas

curl "https://apis.io/api/v1/json-schemas?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.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.