action openstates_people_search_people_get {
  label: "People Search"
  description: "Get list of people matching selected criteria.\n\nMust provide either **jurisdiction**, **name**, or one or more **id** parameters."
  provider: openstates
  method: GET
  path: "/people"
  encoding: json
  input: {
    type: "object"
    properties: {
      apikey: {
        type: "string"
      }
      district: {
        type: "string"
        description: "Filter by district name."
      }
      id: {
        type: "array"
        description: "Filter by id, can be specified multiple times for multiple people."
        items: {
          type: "string"
        }
      }
      include: {
        type: "array"
        description: "Additional information to include in response."
        items: {
          type: "string"
          description: "An enumeration."
          enum: ["other_names", "other_identifiers", "links", "sources", "offices"]
        }
      }
      jurisdiction: {
        type: "string"
        description: "Filter by jurisdiction name or id."
      }
      name: {
        type: "string"
        description: "Filter by name, case-insensitive match."
      }
      org_classification: {
        description: "Filter by current role."
        type: "object"
      }
      page: {
        type: "integer"
      }
      per_page: {
        type: "integer"
      }
      "x-api-key": {
        type: "string"
      }
    }
    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"
                additionalProperties: true
              }
            }
            updated_at: {
              type: "string"
              format: "date-time"
            }
          }
        }
      }
    }
  }
}