v1

latestOpenAPI 3.0.22026-07-13125644.4 KB

people

People Search

Get list of people matching selected criteria.

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

get/people

Query parameters

jurisdictionstring

Filter by jurisdiction name or id.

namestring

Filter by name, case-insensitive match.

idstring[]

Filter by id, can be specified multiple times for multiple people.

org_classification'legislature' | 'executive' | 'lower' | 'upper' | 'government'

An enumeration.

Filter by current role.

districtstring

Filter by district name.

includePersonInclude[]

Additional information to include in response.

pageinteger

per_pageinteger

apikeystring

Headers

x-api-keystring

Response

Successful Response

Example response

{
  "results": [
    {
      "id": "ocd-person/adb58f21-f2fd-4830-85b6-f490b0867d14",
      "name": "Angela Augusta",
      "party": "Democratic",
      "current_role": {
        "title": "Senator",
        "division_id": "ocd-division/country:us/state:nc/sldu:3"
      },
      "jurisdiction": {
        "id": "ocd-jurisdiction/country:us/state:nc/government",
        "name": "North Carolina"
      },
      "given_name": "Angela",
      "family_name": "Augusta",
      "image": "https://example.com/ncimg/3.png",
      "email": "aperson@example.com",
      "gender": "female",
      "birth_date": "1960-05-04",
      "death_date": "2019-04-10",
      "extras": {
        "profession": "Doctor"
      },
      "openstates_url": "https://openstates.org/person/amos-l-quick-iii-28NRPPfJA6FGVl9RrjpKjl/",
      "other_identifiers": [
        {
          "identifier": "NCL000123",
          "scheme": "legacy_openstates"
        }
      ],
      "other_names": [
        {
          "name": "Auggie",
          "note": "nickname"
        }
      ],
      "links": [
        {
          "url": "https://example.com/",
          "note": "homepage"
        }
      ],
      "sources": [
        {
          "url": "https://example.com/",
          "note": "homepage"
        }
      ],
      "offices": [
        {
          "name": "District Office",
          "fax": "919-555-1234",
          "voice": "919-555-0064",
          "address": "212 Maple Lane; Raleigh NC; 27526",
          "classification": "capitol"
        }
      ]
    }
  ],
  "pagination": {
    "per_page": 20,
    "page": 1,
    "max_page": 3,
    "total_items": 52
  }
}