People Geo

v1.0.0

Get list of people currently representing a given location.

Note: Currently limited to state legislators and US Congress. Governors & mayors are not included.

Input

{
  "type": "object",
  "properties": {
    "include": {
      "type": "array",
      "description": "Additional information to include in the response.",
      "items": {
        "type": "string",
        "description": "An enumeration.",
        "enum": [
          "other_names",
          "other_identifiers",
          "links",
          "sources",
          "offices"
        ]
      }
    },
    "lat": {
      "type": "number",
      "description": "Latitude of point."
    },
    "lng": {
      "type": "number",
      "description": "Longitude of point."
    }
  },
  "required": [
    "lat",
    "lng"
  ],
  "additionalProperties": false
}

Output

{
  "type": "object",
  "required": [
    "pagination",
    "results"
  ],
  "properties": {
    "pagination": {
      "type": "object",
      "required": [
        "max_page",
        "page",
        "per_page",
        "total_items"
      ],
      "properties": {
        "max_page": {
          "type": "integer"
        },
        "page": {
          "type": "integer"
        },
        "per_page": {
          "type": "integer"
        },
        "total_items": {
          "type": "integer"
        }
      }
    },
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "id",
          "name",
          "party",
          "jurisdiction",
          "given_name",
          "family_name",
          "image",
          "email",
          "gender",
          "birth_date",
          "death_date",
          "extras",
          "created_at",
          "updated_at",
          "openstates_url"
        ],
        "properties": {
          "birth_date": {
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "current_role": {
            "type": "object",
            "required": [
              "title",
              "org_classification"
            ],
            "properties": {
              "district": {
                "type": "object"
              },
              "division_id": {
                "type": "string"
              },
              "org_classification": {
                "type": "object"
              },
              "title": {
                "type": "string"
              }
            }
          },
          "death_date": {
            "type": "string"
          },
          "email": {
            "type": "string"
          },
          "extras": {
            "type": "object"
          },
          "family_name": {
            "type": "string"
          },
          "gender": {
            "type": "string"
          },
          "given_name": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "image": {
            "type": "string"
          },
          "jurisdiction": {
            "type": "object",
            "required": [
              "id",
              "name",
              "classification"
            ],
            "properties": {
              "classification": {
                "type": "object"
              },
              "id": {
                "type": "string"
              },
              "name": {
                "type": "string"
              }
            }
          },
          "links": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "url",
                "note"
              ],
              "properties": {
                "note": {
                  "type": "string"
                },
                "url": {
                  "type": "string"
                }
              }
            }
          },
          "name": {
            "type": "string"
          },
          "offices": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "name"
              ],
              "properties": {
                "address": {
                  "type": "string"
                },
                "classification": {
                  "type": "string"
                },
                "fax": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "voice": {
                  "type": "string"
                }
              }
            }
          },
          "openstates_url": {
            "type": "string"
          },
          "other_identifiers": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "identifier",
                "scheme"
              ],
              "properties": {
                "identifier": {
                  "type": "string"
                },
                "scheme": {
                  "type": "string"
                }
              }
            }
          },
          "other_names": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "name",
                "note"
              ],
              "properties": {
                "name": {
                  "type": "string"
                },
                "note": {
                  "type": "string"
                }
              }
            }
          },
          "party": {
            "type": "string"
          },
          "sources": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "url",
                "note"
              ],
              "properties": {
                "note": {
                  "type": "string"
                },
                "url": {
                  "type": "string"
                }
              }
            }
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          }
        }
      }
    }
  }
}