Representatives: representativeInfoByDivision
Stay organized with collections
Save and categorize content based on your preferences.
Looks up representative information for a single geographic division.
Try it now.
Request
HTTP request
GET https://www.googleapis.com/civicinfo/v2/representatives/ocdId
Parameters
| Parameter name |
Value |
Description |
| Path parameters |
ocdId |
string |
The Open Civic Data division identifier of the division to look up.
|
| Optional query parameters |
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"
|
recursive |
boolean |
If true, information about all divisions contained in the division
requested will be included as well. For example, if querying
ocd-division/country:us/district:dc, this would also return all DC's
wards and ANCs.
|
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.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-03-25 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-03-25 UTC."],[[["Retrieves representative information for a specified geographic division using its Open Civic Data (OCD) ID."],["Allows filtering results by office levels and roles for refined searches."],["Includes an option to recursively retrieve information for all sub-divisions within the requested division."],["The Representatives API is scheduled for decommissioning in April 2025; alternative solutions will be necessary."]]],[]]