---
title: "People Search"
method: GET
path: "/people"
tags: ["people"]
---

# People Search

`GET /people`

Get list of people matching selected criteria.

Must provide either **jurisdiction**, **name**, or one or more **id** parameters.

## Query parameters

- `jurisdiction` string — Filter by jurisdiction name or id.
- `name` string — Filter by name, case-insensitive match.
- `id` string[] — Filter by id, can be specified multiple times for multiple people.
- `org_classification` 'legislature' | 'executive' | 'lower' | 'upper' | 'government' — An enumeration.
- `district` string — Filter by district name.
- `include` PersonInclude[] — Additional information to include in response.
- `page` integer
- `per_page` integer
- `apikey` string

## Headers

- `x-api-key` string

## Response `200`

Successful Response

- PersonList
  - `results` Person[], required
    - `id` string, required
    - `name` string, required
    - `party` string, required
    - `current_role` CurrentRole
      - `title` string, required
      - `org_classification` 'legislature' | 'executive' | 'lower' | 'upper' | 'government', required — An enumeration.
      - `district` union
        - string
        - integer
      - `division_id` string
    - `jurisdiction` CompactJurisdiction, required
      - `id` string, required
      - `name` string, required
      - `classification` 'state' | 'municipality' | 'country', required — An enumeration.
    - `given_name` string, required
    - `family_name` string, required
    - `image` string, required
    - `email` string, required
    - `gender` string, required
    - `birth_date` string, required
    - `death_date` string, required
    - `extras` object, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `openstates_url` string, required
    - `other_identifiers` AltIdentifier[]
      - `identifier` string, required
      - `scheme` string, required
    - `other_names` AltName[]
      - `name` string, required
      - `note` string, required
    - `links` Link[]
      - `url` string, required
      - `note` string
    - `sources` Link[]
      - `url` string, required
      - `note` string
    - `offices` Office[]
      - `name` string, required
      - `fax` string
      - `voice` string
      - `address` string
      - `classification` string
  - `pagination` PaginationMeta, required
    - `per_page` integer, required
    - `page` integer, required
    - `max_page` integer, required
    - `total_items` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/openstates/apis/open-states-api-v3.md) · [All operations](https://skmtc.dev/openstates/apis/open-states-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openstates/open-states-api-v3/revisions/6d7f86636f9d/schema)