Api-roll 42: 2016-11-08

discovery/googleapis/civicinfo__v2.json

 {
     "basePath": "/civicinfo/v2/",
     "baseUrl": "https://www.googleapis.com/civicinfo/v2/",
     "batchPath": "batch",
     "canonicalName": "Civic Info",
     "description": "Provides polling places, early vote locations, contest data, election officials, and government representatives for U.S. residential addresses.",
     "discoveryVersion": "v1",
     "documentationLink": "https://developers.google.com/civic-information",
-    "etag": "\"C5oy1hgQsABtYOYIOXWcR3BgYqU/0RRptSlHJI7MXoKAqjNEurqVvHk\"",
+    "etag": "\"C5oy1hgQsABtYOYIOXWcR3BgYqU/o3I9HhfXj9W3CUHRNSzja8F9LG4\"",
     "icons": {
         "x16": "http://www.google.com/images/icons/product/search-16.gif",
         "x32": "http://www.google.com/images/icons/product/search-32.gif"
     },
     "id": "civicinfo:v2",
     "kind": "discovery#restDescription",
     "name": "civicinfo",
     "ownerDomain": "google.com",
     "ownerName": "Google",
     "parameters": {
@@ skipping 50 matching lines @@
                     "httpMethod": "GET",
                     "id": "civicinfo.divisions.search",
                     "parameters": {
                         "query": {
                             "description": "The search query. Queries can cover any parts of a OCD ID or a human readable division name. All words given in the query are treated as required patterns. In addition to that, most query operators of the Apache Lucene library are supported. See http://lucene.apache.org/core/2_9_4/queryparsersyntax.html",
                             "location": "query",
                             "type": "string"
                         }
                     },
                     "path": "divisions",
+                    "request": {
+                        "$ref": "DivisionSearchRequest"
+                    },
                     "response": {
                         "$ref": "DivisionSearchResponse"
                     }
                 }
             }
         },
         "elections": {
             "methods": {
                 "electionQuery": {
                     "description": "List of available elections to query.",
                     "httpMethod": "GET",
                     "id": "civicinfo.elections.electionQuery",
                     "path": "elections",
+                    "request": {
+                        "$ref": "ElectionsQueryRequest"
+                    },
                     "response": {
                         "$ref": "ElectionsQueryResponse"
                     }
                 },
                 "voterInfoQuery": {
                     "description": "Looks up information relevant to a voter based on the voter's registered address.",
                     "httpMethod": "GET",
                     "id": "civicinfo.elections.voterInfoQuery",
                     "parameterOrder": [
                         "address"
@@ skipping 19 matching lines @@
                             "type": "boolean"
                         },
                         "returnAllAvailableData": {
                             "default": "false",
                             "description": "If set to true, the query will return the success codeand include any partial information when it is unable to determine a matching address or unable to determine the election for electionId=0 queries.",
                             "location": "query",
                             "type": "boolean"
                         }
                     },
                     "path": "voterinfo",
+                    "request": {
+                        "$ref": "VoterInfoRequest"
+                    },
                     "response": {
                         "$ref": "VoterInfoResponse"
                     }
                 }
             }
         },
         "representatives": {
             "methods": {
                 "representativeInfoByAddress": {
                     "description": "Looks up political geography and representative information for a single address.",
@@ skipping 66 matching lines @@
                                 "",
                                 "",
                                 ""
                             ],
                             "location": "query",
                             "repeated": true,
                             "type": "string"
                         }
                     },
                     "path": "representatives",
+                    "request": {
+                        "$ref": "RepresentativeInfoRequest"
+                    },
                     "response": {
                         "$ref": "RepresentativeInfoResponse"
                     }
                 },
                 "representativeInfoByDivision": {
                     "description": "Looks up representative information for a single geographic division.",
                     "httpMethod": "GET",
                     "id": "civicinfo.representatives.representativeInfoByDivision",
                     "parameterOrder": [
                         "ocdId"
@@ skipping 65 matching lines @@
                                 "",
                                 "",
                                 ""
                             ],
                             "location": "query",
                             "repeated": true,
                             "type": "string"
                         }
                     },
                     "path": "representatives/{ocdId}",
+                    "request": {
+                        "$ref": "DivisionRepresentativeInfoRequest"
+                    },
                     "response": {
                         "$ref": "RepresentativeInfoData"
                     }
                 }
             }
         }
     },
-    "revision": "20160823",
+    "revision": "20161102",
     "rootUrl": "https://www.googleapis.com/",
     "schemas": {
         "AdministrationRegion": {
             "description": "Describes information about a regional election administrative area.",
             "id": "AdministrationRegion",
             "properties": {
                 "electionAdministrationBody": {
                     "$ref": "AdministrativeBody",
                     "description": "The election administration body for this area."
                 },
@@ skipping 103 matching lines @@
                     "items": {
                         "$ref": "Channel"
                     },
                     "type": "array"
                 },
                 "email": {
                     "description": "The email address for the candidate's campaign.",
                     "type": "string"
                 },
                 "name": {
-                    "description": "The candidate's name.",
+                    "description": "The candidate's name. If this is a joint ticket it will indicate the name of the candidate at the top of a ticket followed by a / and that name of candidate at the bottom of the ticket. e.g. \"Mitt Romney / Paul Ryan\"",
                     "type": "string"
                 },
                 "orderOnBallot": {
                     "description": "The order the candidate appears on the ballot for this contest.",
                     "format": "int64",
                     "type": "string"
                 },
                 "party": {
                     "description": "The full name of the party the candidate is a member of.",
                     "type": "string"
@@ skipping 138 matching lines @@
                     "description": "\"Yes\" or \"No\" depending on whether this a contest being held outside the normal election cycle.",
                     "type": "string"
                 },
                 "type": {
                     "description": "The type of contest. Usually this will be 'General', 'Primary', or 'Run-off' for contests with candidates. For referenda this will be 'Referendum'. For Retention contests this will typically be 'Retention'.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
+        "ContextParams": {
+            "id": "ContextParams",
+            "properties": {
+                "clientProfile": {
+                    "type": "string"
+                }
+            },
+            "type": "object"
+        },
+        "DivisionRepresentativeInfoRequest": {
+            "description": "A request to look up representative information for a single division.",
+            "id": "DivisionRepresentativeInfoRequest",
+            "properties": {
+                "contextParams": {
+                    "$ref": "ContextParams"
+                }
+            },
+            "type": "object"
+        },
+        "DivisionSearchRequest": {
+            "description": "A search request for political geographies.",
+            "id": "DivisionSearchRequest",
+            "properties": {
+                "contextParams": {
+                    "$ref": "ContextParams"
+                }
+            },
+            "type": "object"
+        },
         "DivisionSearchResponse": {
             "description": "The result of a division search query.",
             "id": "DivisionSearchResponse",
             "properties": {
                 "kind": {
                     "default": "civicinfo#divisionSearchResponse",
                     "description": "Identifies what kind of resource this is. Value: the fixed string \"civicinfo#divisionSearchResponse\".",
                     "type": "string"
                 },
                 "results": {
@@ skipping 71 matching lines @@
                     "description": "The office phone number of the election official.",
                     "type": "string"
                 },
                 "title": {
                     "description": "The title of the election official.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
+        "ElectionsQueryRequest": {
+            "id": "ElectionsQueryRequest",
+            "properties": {
+                "contextParams": {
+                    "$ref": "ContextParams"
+                }
+            },
+            "type": "object"
+        },
         "ElectionsQueryResponse": {
             "description": "The list of elections available for this version of the API.",
             "id": "ElectionsQueryResponse",
             "properties": {
                 "elections": {
                     "description": "A list of available elections",
                     "items": {
                         "$ref": "Election"
                     },
                     "type": "array"
@@ skipping 191 matching lines @@
                     "description": "The first date that this early vote site or drop off location may be used. This field is not populated for polling locations.",
                     "type": "string"
                 },
                 "voterServices": {
                     "description": "The services provided by this early vote site or drop off location. This field is not populated for polling locations.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
+        "PostalAddress": {
+            "id": "PostalAddress",
+            "properties": {
+                "addressLines": {
+                    "items": {
+                        "type": "string"
+                    },
+                    "type": "array"
+                },
+                "administrativeAreaName": {
+                    "type": "string"
+                },
+                "countryName": {
+                    "type": "string"
+                },
+                "countryNameCode": {
+                    "type": "string"
+                },
+                "dependentLocalityName": {
+                    "type": "string"
+                },
+                "dependentThoroughfareLeadingType": {
+                    "type": "string"
+                },
+                "dependentThoroughfareName": {
+                    "type": "string"
+                },
+                "dependentThoroughfarePostDirection": {
+                    "type": "string"
+                },
+                "dependentThoroughfarePreDirection": {
+                    "type": "string"
+                },
+                "dependentThoroughfareTrailingType": {
+                    "type": "string"
+                },
+                "dependentThoroughfaresConnector": {
+                    "type": "string"
+                },
+                "dependentThoroughfaresIndicator": {
+                    "type": "string"
+                },
+                "dependentThoroughfaresType": {
+                    "type": "string"
+                },
+                "firmName": {
+                    "type": "string"
+                },
+                "isDisputed": {
+                    "type": "boolean"
+                },
+                "languageCode": {
+                    "type": "string"
+                },
+                "localityName": {
+                    "type": "string"
+                },
+                "postBoxNumber": {
+                    "type": "string"
+                },
+                "postalCodeNumber": {
+                    "type": "string"
+                },
+                "postalCodeNumberExtension": {
+                    "type": "string"
+                },
+                "premiseName": {
+                    "type": "string"
+                },
+                "recipientName": {
+                    "type": "string"
+                },
+                "sortingCode": {
+                    "type": "string"
+                },
+                "subAdministrativeAreaName": {
+                    "type": "string"
+                },
+                "subPremiseName": {
+                    "type": "string"
+                },
+                "thoroughfareLeadingType": {
+                    "type": "string"
+                },
+                "thoroughfareName": {
+                    "type": "string"
+                },
+                "thoroughfareNumber": {
+                    "type": "string"
+                },
+                "thoroughfarePostDirection": {
+                    "type": "string"
+                },
+                "thoroughfarePreDirection": {
+                    "type": "string"
+                },
+                "thoroughfareTrailingType": {
+                    "type": "string"
+                }
+            },
+            "type": "object"
+        },
         "RepresentativeInfoData": {
             "id": "RepresentativeInfoData",
             "properties": {
                 "divisions": {
                     "additionalProperties": {
                         "$ref": "GeographicDivision",
                         "description": "The unique Open Civic Data identifier for this division."
                     },
                     "description": "Political geographic divisions that contain the requested address.",
                     "type": "object"
                 },
                 "offices": {
                     "description": "Elected offices referenced by the divisions listed above. Will only be present if includeOffices was true in the request.",
                     "items": {
                         "$ref": "Office"
                     },
                     "type": "array"
                 },
                 "officials": {
                     "description": "Officials holding the offices listed above. Will only be present if includeOffices was true in the request.",
                     "items": {
                         "$ref": "Official"
                     },
                     "type": "array"
                 }
             },
             "type": "object"
         },
+        "RepresentativeInfoRequest": {
+            "description": "A request for political geography and representative information for an address.",
+            "id": "RepresentativeInfoRequest",
+            "properties": {
+                "contextParams": {
+                    "$ref": "ContextParams"
+                }
+            },
+            "type": "object"
+        },
         "RepresentativeInfoResponse": {
             "description": "The result of a representative info lookup query.",
             "id": "RepresentativeInfoResponse",
             "properties": {
                 "divisions": {
                     "additionalProperties": {
                         "$ref": "GeographicDivision",
                         "description": "The unique Open Civic Data identifier for this division."
                     },
                     "description": "Political geographic divisions that contain the requested address.",
@@ skipping 68 matching lines @@
                     "description": "The name of the data source.",
                     "type": "string"
                 },
                 "official": {
                     "description": "Whether this data comes from an official government source.",
                     "type": "boolean"
                 }
             },
             "type": "object"
         },
+        "VoterInfoRequest": {
+            "description": "A request for information about a voter.",
+            "id": "VoterInfoRequest",
+            "properties": {
+                "contextParams": {
+                    "$ref": "ContextParams"
+                },
+                "voterInfoSegmentResult": {
+                    "$ref": "VoterInfoSegmentResult"
+                }
+            },
+            "type": "object"
+        },
         "VoterInfoResponse": {
             "description": "The result of a voter info lookup query.",
             "id": "VoterInfoResponse",
             "properties": {
                 "contests": {
                     "description": "Contests that will appear on the voter's ballot.",
                     "items": {
                         "$ref": "Contest"
                     },
                     "type": "array"
@@ skipping 48 matching lines @@
                 },
                 "state": {
                     "description": "Local Election Information for the state that the voter votes in. For the US, there will only be one element in this array.",
                     "items": {
                         "$ref": "AdministrationRegion"
                     },
                     "type": "array"
                 }
             },
             "type": "object"
+        },
+        "VoterInfoSegmentResult": {
+            "id": "VoterInfoSegmentResult",
+            "properties": {
+                "generatedMillis": {
+                    "format": "int64",
+                    "type": "string"
+                },
+                "postalAddress": {
+                    "$ref": "PostalAddress"
+                },
+                "request": {
+                    "$ref": "VoterInfoRequest"
+                },
+                "response": {
+                    "$ref": "VoterInfoResponse"
+                }
+            },
+            "type": "object"
         }
     },
     "servicePath": "civicinfo/v2/",
     "title": "Google Civic Information API",
     "version": "v2"
 }