Representatives: representativeInfoByAddress

Looks up political geography and representative information for a single address. Try it now.

Request

HTTP request

GET https://www.googleapis.com/civicinfo/v2/representatives

Parameters

Parameter name Value Description
Optional query parameters
address string The address to look up. May only be specified if the field ocdId is not given in the URL.
includeOffices boolean Whether to return information about offices and officials. If false, only the top-level district information will be returned. (Default: true)
levels string A list of office levels to filter by. Only offices that serve at least one of these levels will be returned. Divisions that don't contain a matching office will not be returned.

Acceptable values are:
  • "administrativeArea1"
  • "administrativeArea2"
  • "country"
  • "international"
  • "locality"
  • "regional"
  • "special"
  • "subLocality1"
  • "subLocality2"
roles string A list of office roles to filter by. Only offices fulfilling one of these roles will be returned. Divisions that don't contain a matching office will not be returned.

Acceptable values are:
  • "deputyHeadOfGovernment"
  • "executiveCouncil"
  • "governmentOfficer"
  • "headOfGovernment"
  • "headOfState"
  • "highestCourtJudge"
  • "judge"
  • "legislatorLowerBody"
  • "legislatorUpperBody"
  • "schoolBoard"
  • "specialPurposeOfficer"

Request body

Do not supply a request body with this method.

Response

If successful, this method returns a response body with the following structure:

{
  "kind": "civicinfo#representativeInfoResponse",
  "normalizedInput": {
    "locationName": string,
    "line1": string,
    "line2": string,
    "line3": string,
    "city": string,
    "state": string,
    "zip": string
  },
  "divisions": {
    (key): {
      "name": string,
      "alsoKnownAs": [
        string
      ],
      "officeIndices": [
        unsigned integer
      ]
    }
  },
  "offices": [
    {
      "name": string,
      "divisionId": string,
      "levels": [
        string
      ],
      "roles": [
        string
      ],
      "sources": [
        {
          "name": string,
          "official": boolean
        }
      ],
      "officialIndices": [
        unsigned integer
      ]
    }
  ],
  "officials": [
    {
      "name": string,
      "address": [
        {
          "locationName": string,
          "line1": string,
          "line2": string,
          "line3": string,
          "city": string,
          "state": string,
          "zip": string
        }
      ],
      "party": string,
      "phones": [
        string
      ],
      "urls": [
        string
      ],
      "photoUrl": string,
      "emails": [
        string
      ],
      "channels": [
        {
          "type": string,
          "id": string
        }
      ]
    }
  ]
}
Property name Value Description Notes
kind string Identifies what kind of resource this is. Value: the fixed string "civicinfo#representativeInfoResponse".
normalizedInput nested object The normalized version of the requested address
normalizedInput.locationName string The name of the location.
normalizedInput.line1 string The street name and number of this address.
normalizedInput.line2 string The second line the address, if needed.
normalizedInput.line3 string The third line of the address, if needed.
normalizedInput.city string The city or town for the address.
normalizedInput.state string The US two letter state abbreviation of the address.
normalizedInput.zip string The US Postal Zip Code of the address.
divisions object Political geographic divisions that contain the requested address. For more details, see the Representatives resource documentation.
offices[] list Elected offices referenced by the divisions listed above. Will only be present if includeOffices was true in the request. For more details, see the Representatives resource documentation.
officials[] list Officials holding the offices listed above. Will only be present if includeOffices was true in the request. For more details, see the Representatives resource documentation.

Try it!

Use the APIs Explorer below to call this method on live data and see the response. Alternatively, try the standalone Explorer.