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"}
        }
      }
    }
  }
}