Officials

Use Officials endpoints to get information on elected officials by name or by region.

Operations

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": { … }
  }
}

Officials

Find elected officials

Request

Query

Headers

Responses

Was this helpful?