action openstates_bills_search_bills_get {
  label: "Bills Search"
  description: "Search for bills matching given criteria.\n\nMust either specify a jurisdiction or a full text query (q).  Additional parameters will\nfuther restrict bills returned."
  provider: openstates
  method: GET
  path: "/bills"
  encoding: json
  input: {
    type: "object"
    properties: {
      action_since: {
        type: "string"
        description: "Filter to only include bills with an action since a given date."
      }
      apikey: {
        type: "string"
      }
      chamber: {
        type: "string"
        description: "Filter by chamber of origination."
      }
      classification: {
        type: "string"
        description: "Filter by classification, e.g. bill or resolution"
      }
      created_since: {
        type: "string"
        description: "Filter to only include bills created since a given date."
      }
      identifier: {
        type: "array"
        description: "Filter to only include bills with this identifier."
        items: {
          type: "string"
        }
      }
      include: {
        type: "array"
        description: "Additional information to include in response."
        items: {
          type: "string"
          description: "An enumeration."
          enum: ["sponsorships", "abstracts", "other_titles", "other_identifiers", "actions", "sources", "documents", "versions", "votes", "related_bills"]
        }
      }
      jurisdiction: {
        type: "string"
        description: "Filter by jurisdiction name or ID."
      }
      page: {
        type: "integer"
      }
      per_page: {
        type: "integer"
      }
      q: {
        type: "string"
        description: "Filter by full text search term."
      }
      session: {
        type: "string"
        description: "Filter by session identifier."
      }
      sort: {
        description: "Desired sort order for bill results."
        type: "object"
      }
      sponsor: {
        type: "string"
        description: "Filter to only include bills sponsored by a given name or person ID."
      }
      sponsor_classification: {
        type: "string"
        description: "Filter matched sponsors to only include particular types of sponsorships."
      }
      subject: {
        type: "array"
        description: "Filter by one or more subjects."
        items: {
          type: "string"
        }
      }
      updated_since: {
        type: "string"
        description: "Filter to only include bills with updates since a given date."
      }
      "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", "session", "jurisdiction", "from_organization", "identifier", "title", "created_at", "updated_at", "openstates_url"]
          properties: {
            abstracts: {
              type: "array"
              items: {
                type: "object"
                required: ["abstract", "note"]
                properties: {
                  abstract: {
                    type: "string"
                  }
                  note: {
                    type: "string"
                  }
                }
              }
            }
            actions: {
              type: "array"
              items: {
                type: "object"
                required: ["organization", "description", "date", "classification", "order"]
                properties: {
                  classification: {
                    type: "array"
                    items: {
                      type: "string"
                    }
                  }
                  date: {
                    type: "string"
                  }
                  description: {
                    type: "string"
                  }
                  order: {
                    type: "integer"
                  }
                  organization: {
                    type: "object"
                    required: ["id", "name", "classification"]
                    properties: {
                      classification: {
                        type: "string"
                      }
                      id: {
                        type: "string"
                      }
                      name: {
                        type: "string"
                      }
                    }
                  }
                }
              }
            }
            classification: {
              type: "array"
              items: {
                type: "string"
              }
            }
            created_at: {
              type: "string"
              format: "date-time"
            }
            documents: {
              type: "array"
              items: {
                type: "object"
                required: ["note", "date", "links"]
                properties: {
                  date: {
                    type: "string"
                  }
                  links: {
                    type: "array"
                    items: {
                      type: "object"
                      required: ["url", "media_type"]
                      properties: {
                        media_type: {
                          type: "string"
                        }
                        url: {
                          type: "string"
                        }
                      }
                    }
                  }
                  note: {
                    type: "string"
                  }
                }
              }
            }
            extras: {
              type: "object"
            }
            first_action_date: {
              type: "string"
            }
            from_organization: {
              type: "object"
              additionalProperties: true
            }
            id: {
              type: "string"
            }
            identifier: {
              type: "string"
            }
            jurisdiction: {
              type: "object"
              required: ["id", "name", "classification"]
              properties: {
                classification: {
                  type: "object"
                }
                id: {
                  type: "string"
                }
                name: {
                  type: "string"
                }
              }
            }
            latest_action_date: {
              type: "string"
            }
            latest_action_description: {
              type: "string"
            }
            latest_passage_date: {
              type: "string"
            }
            openstates_url: {
              type: "string"
            }
            other_identifiers: {
              type: "array"
              items: {
                type: "object"
                required: ["identifier"]
                properties: {
                  identifier: {
                    type: "string"
                  }
                }
              }
            }
            other_titles: {
              type: "array"
              items: {
                type: "object"
                required: ["title", "note"]
                properties: {
                  note: {
                    type: "string"
                  }
                  title: {
                    type: "string"
                  }
                }
              }
            }
            related_bills: {
              type: "array"
              items: {
                type: "object"
                required: ["identifier", "legislative_session", "relation_type"]
                properties: {
                  identifier: {
                    type: "string"
                  }
                  legislative_session: {
                    type: "string"
                  }
                  relation_type: {
                    type: "string"
                  }
                }
              }
            }
            session: {
              type: "string"
            }
            sources: {
              type: "array"
              items: {
                type: "object"
                required: ["url", "note"]
                properties: {
                  note: {
                    type: "string"
                  }
                  url: {
                    type: "string"
                  }
                }
              }
            }
            sponsorships: {
              type: "array"
              items: {
                type: "object"
                required: ["name", "entity_type", "primary", "classification"]
                properties: {
                  classification: {
                    type: "string"
                  }
                  entity_type: {
                    type: "string"
                  }
                  name: {
                    type: "string"
                  }
                  organization: {
                    type: "object"
                  }
                  person: {
                    type: "object"
                    required: ["id", "name", "party"]
                    properties: {
                      current_role: {
                        type: "object"
                        required: ["title", "org_classification"]
                        properties: {
                          district: {
                            type: "object"
                          }
                          division_id: {
                            type: "string"
                          }
                          org_classification: {
                            type: "object"
                          }
                          title: {
                            type: "string"
                          }
                        }
                      }
                      id: {
                        type: "string"
                      }
                      name: {
                        type: "string"
                      }
                      party: {
                        type: "string"
                      }
                    }
                  }
                  primary: {
                    type: "boolean"
                  }
                }
              }
            }
            subject: {
              type: "array"
              items: {
                type: "string"
              }
            }
            title: {
              type: "string"
            }
            updated_at: {
              type: "string"
              format: "date-time"
            }
            versions: {
              type: "array"
              items: {
                type: "object"
                additionalProperties: true
              }
            }
            votes: {
              type: "array"
              items: {
                type: "object"
                required: ["id", "motion_text", "start_date", "result", "identifier", "extras", "organization", "votes", "counts", "sources"]
                properties: {
                  counts: {
                    type: "array"
                    items: {
                      type: "object"
                      required: ["option", "value"]
                      properties: {
                        option: {
                          type: "string"
                        }
                        value: {
                          type: "integer"
                        }
                      }
                    }
                  }
                  extras: {
                    type: "object"
                  }
                  id: {
                    type: "string"
                  }
                  identifier: {
                    type: "string"
                  }
                  motion_classification: {
                    type: "array"
                    items: {
                      type: "string"
                    }
                  }
                  motion_text: {
                    type: "string"
                  }
                  organization: {
                    type: "object"
                    additionalProperties: true
                  }
                  result: {
                    type: "string"
                  }
                  sources: {
                    type: "array"
                    items: {
                      type: "object"
                      additionalProperties: true
                    }
                  }
                  start_date: {
                    type: "string"
                  }
                  votes: {
                    type: "array"
                    items: {
                      type: "object"
                      required: ["option", "voter_name"]
                      properties: {
                        option: {
                          type: "string"
                        }
                        voter: {
                          type: "object"
                          additionalProperties: true
                        }
                        voter_name: {
                          type: "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}