---
title: "Find elected officials by region"
method: GET
path: "/officials_by_region"
tags: ["Officials"]
---

# Find elected officials by region

`GET /officials_by_region`

This resource provides the ability to list elected officials by level and region rather than for a single geographic location. The endpoint is filtered by district type and region, and sorted by `last_name`, `first_name`.

Cost: 50 credits

Permission: Please contact the Cicero Team to request access to this resource.

## Query parameters

- `format` 'json' | 'xml'
- `customer_id` string, password, required
- `key` string, password
- `district_type` string, required
- `country` string, required
- `city` string
- `state` string
- `district_id` string
- `max` integer
- `offset` integer

## Headers

- `Accept` 'application/json' | '*/*', required
- `Content-Type` 'application/json' | 'application/xml', required

## Response `200`

Successful response

- object
  - `response` ResponseOfficialsByRegion
    - `errors` unknown[] — If the request encountered an error or errors, details about the error(s) will be contained in this field.
      - unknown
    - `messages` unknown[] — Contains the resources matching the request query, if any.
      - unknown
    - `results` object — Contains additional information about the outcome of a request that is not an error and not part of a query result.
      - `officials` OfficialsByRegionObject[]
        - `first_name` string — First name of the official. Sometimes, an official will have a preferred_name that they are more commonly known by.
        - `middle_initial` string — Middle name or initial of the official.
        - `last_name` string — Last name of the official.
        - `preferred_name` string — A name commonly used instead of the official's given first name. This property has a value only if it differs from the first_name.
        - `salutation` string — Official's formal salutation. Some assemblies use formal titles such as “Honorable”.
        - `name_suffix` string — Name suffix of the official (e.g., “Jr.”, “III”, “Ph.D.”).
        - `sk` number — The surrogate key for the official.
        - `party` string — Political party designation of the official. Might be “Nonpartisan” in cases where the government specifically uses that term.
        - `district` DistrictObjectOfficialByRegion
          - `district_id` string — The identifying code for the district within its delegation or district type. For example, a legislative delegation's 5th district would probably have a district_id of '5'. Non-legislative districts might have an ID assigned by the managing agency (e.g., US Census Block Groups have a GEOID).
          - `district_type__name_short` string — The level of government the district represents. See the district_type metadata endpoint for a list of possibilities.
          - `subtype` string — An additional categorization within district_type.
          - `label` string — Descriptive text associated with a district_id, such as the label for the district (e.g. “5th Ward”), or a full label for the district (e.g. “Sealaska Alaska Native Regional Corporation”).
        - `state` string — The state, province, or region of the official's district.
        - `chamber__name_formal` string — The formal name of the official's chamber.
        - `title` string — The primary title the official holds.
        - `addresses` AddressObject[] — A list of address objects with the official's contact information, such as mailing address, phone, and fax.
          - `address_1` string — The first line of the street address.
          - `address_2` string — The second line of the street address.
          - `address_3` string — The third line of the street address.
          - `city` string — The city of the address.
          - `county` string — Deprecated.
          - `state` string — The state, province, or other region of the address.
          - `postal_code` string — The postal code for the address.
          - `phone_1` string — The primary phone number for contacting the address.
          - `fax_1` string — The primary fax number for the address.
          - `phone_2` string — The secondary phone number for contacting the address.
          - `fax_2` string — The secondary fax number for the address.
        - `email_addresses` string[] — A list of the official's email addresses.
        - `phone_1` string — The primary phone number for the official's primary address.
        - `phone_2` string — The secondary phone number for the official's primary address.
        - `photo_origin_url` string — A URL for a headshot photo of the official.
        - `web_form_url` string — A web form URL for contacting the official.
        - `valid_from` string — Date the official was inaugurated in this office. Changes with redistricting or election to a new office, but not when an incumbent starts a consecutive term.
        - `valid_to` string — Date the official's term in office expires. This date would be extended if the official wins re-election.
        - `identifiers` object[] — A list of abbreviated identifier objects containing only identifier_type and identifier_value for official Facebook and Twitter accounts.
          - `identifier_type` string — The platform referred to by the identifier.
          - `identifier_value` string — The identifying value for the official on this type of platform. Could be either a profile ID or a full URL.
      - `count` CountObject
        - `from` integer
        - `to` integer
        - `total` integer

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/melissa/apis/cicero.md) · [All operations](https://skmtc.net/melissa/apis/cicero/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/melissa/cicero/revisions/34d86f140b3f/schema)