Find elected officials by region

Request

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

formatstring

Specify the desired format of the response.

Enum:"json""xml"

Example:format=json

customer_idstring, (password)required

Required. The License Key issued by Melissa.

Example:customer_id={REPLACE-WITH-YOUR-LICENSE-KEY}

keystring, (password)deprecated

The License Key issued by Melissa.

district_typestringrequired

Required. The type of district.

Example:district_type=NATIONAL_LOWER

countrystringrequired

Required. The country of the location (Use ISO 3166-1 alpha-2 code) used as a filter.

Example:country=US

citystring

The city of the location used as a filter.

statestring

The state of the location used as a filter.

Example:state=CA

district_idstring

The ID, number, or name of the official's district.

maxinteger

The maximum number of objects to return.

offsetinteger

Number of items to skip in the response, starting from the beginning of the list.

Acceptstringrequired

Format of the response.

Enum:"application/json""*/*"

Example:*/*

Content-Typestringrequired

Format of the request.

Enum:"application/json""application/xml"

curl -i -X GET \
  'https://app.cicerodata.com/v3.1/officials_by_region?customer_id=%7BREPLACE-WITH-YOUR-LICENSE-KEY%7D&district_type=NATIONAL_LOWER&country=US' \
  -H 'Accept: */*' \
  -H 'Content-Type: application/json'

Responses

Successful response

Body

responseobject

Response

{
  "response": {
    "errors": [],
    "messages": [],
    "results": { … }
  }
}