Find elected officials

Request

Elected Officials 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

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.

latstringrequired

Required. The latitude of the location.

Example:lat=33.63756710910554

lonstringrequired

Required. The longitude of the location.

Example:lon=-117.60695049134513

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.

sortstring

Whether to sort the results in ascending or descending order.

Default:"asc"

Enum:"asc""desc"

district_typestring

The type of district.

Example:district_type=NATIONAL_LOWER

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, <= 200

The maximum number of objects to return.

Default:40

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://electedofficials.melissadata.net/v3.1/official?customer_id=%7BREPLACE-WITH-YOUR-LICENSE-KEY%7D&lat=33.63756710910554&lon=-117.60695049134513' \
  -H 'Accept: */*' \
  -H 'Content-Type: application/json'

Responses

Successful response

Body

responseobject

Response

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