v1

latestOpenAPI 3.1.22026-08-061127187.7 KB
Officials

Find elected officials

Cicero tracks elected officials and makes their information available through the official resource. The default response ordering is by last_name, first_name.

Use location queries on this resource. You can also query for officials using the official's name.

Cost: 1 credit

get/official

Query parameters

format'json' | 'xml'

Specify the desired format of the response.

customer_idstring password required

Required. The License Key issued by Melissa.

keystring password

The License Key issued by Melissa.

latstring required

Required. The latitude of the location.

lonstring required

Required. The longitude of the location.

search_locstring

Required. One line address or a single search string.

search_addressstring

Required. The street address of the location.

search_neighborhoodstring

Required. The official neighborhood of the location (in countries with postal designations e.g., Mexico).

search_citystring

Required. The city of the location.

search_statestring

Required. The state of the location.

search_postalstring

Required. The postal code of the location.

search_countrystring

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

last_namestring

Required. The official's last name.

first_namestring

The official's first name.

citystring

The city of the location used as a filter.

statestring

The state of the location used as a filter.

countrystring

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

orderstring

The name of the resource field by which to order the results.

sort'asc' | 'desc'

Whether to sort the results in ascending or descending order.

district_typestring

The type of district.

district_idstring

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

valid_onstring

The date the district is valid on. Date should be specified in a YYYY-MM-DD format.

valid_on_or_afterstring

The date the district is valid on or after. Date should be specified in a YYYY-MM-DD format.

valid_on_or_beforestring

The date the district is valid on or before. Date should be specified in a YYYY-MM-DD format.

valid_rangestring

The dates during which the district is valid. Dates should be specified in a YYYY-MM-DD format and separated by a comma. Use ALL to return every district in all valid date ranges.

maxinteger

The maximum number of objects to return.

offsetinteger

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

Headers

Accept'application/json' | '*/*' required

Format of the response.

Content-Type'application/json' | 'application/xml' required

Format of the request.

Response

Successful response

All 11 operations