Skip to content
  • Events

    Use Events endpoints to get information on election and redistricting events.

    Find election events

    Request

    Elected Officials tracks elections occurring in every country around the world and makes information about the elections available through the election_event resource. The default response ordering is by election_expire_date.

    Cost: 0 credits

    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.

    election_expire_date_on_or_afterstring

    The earliest date an election is completed. Use today for elections completing today or later. Date should be specified in a YYYY-MM-DD format.

    Example:election_expire_date_on_or_after=today
    election_expire_date_beforestring

    The latest date an election is completed. Use tomorrow for elections completing before tomorrow. Date should be specified in a YYYY-MM-DD format.

    Example:election_expire_date_before=
    maxinteger

    The maximum number of objects to return.

    Example:max=
    offsetinteger

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

    Example:offset=
    Headers
    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/election_event?customer_id=%7BREPLACE-WITH-YOUR-LICENSE-KEY%7D' \
      -H 'Accept: */*' \
      -H 'Content-Type: application/json'

    Responses

    Successful response

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