Raw schema
{
"type": "object",
"properties": {
"query": {
"default": "",
"description": "A question or keywords, in plain language. Empty with filters: browse.",
"maxLength": 2000,
"title": "Query",
"type": "string"
},
"filters": {
"anyOf": [
{
"$ref": "#/$defs/Filters"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional hard filters (see describe_site for values)."
},
"linked_to": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Only documents linked to this document id (a bill's meetings, a section's amending bills).",
"title": "Linked To"
},
"relations": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "With linked_to: relation types (discusses, amends, amendment_to, cites, ...).",
"title": "Relations"
},
"parent": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Only documents inside this hierarchy node (code:t16, code:t16/c11, ga-const:art-i).",
"title": "Parent"
},
"versions": {
"default": "current",
"description": "current (default) or all versions (how a bill changed).",
"enum": [
"current",
"all"
],
"title": "Versions",
"type": "string"
},
"mode": {
"default": "best",
"description": "best: ranked and cut. all: every match found, by date, paged, with a total.",
"enum": [
"best",
"all"
],
"title": "Mode",
"type": "string"
},
"sort": {
"default": "relevance",
"description": "Result order.",
"enum": [
"relevance",
"newest",
"oldest",
"id"
],
"title": "Sort",
"type": "string"
},
"limit": {
"anyOf": [
{
"maximum": 50,
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Results per page: 1 to 50 (default 10 documents; 25 in mode all).",
"title": "Limit"
},
"cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "The next_cursor of a previous call, for the next page.",
"title": "Cursor"
}
},
"$defs": {
"Filters": {
"additionalProperties": false,
"description": "Hard filters. Every field is optional; values come from the vocabularies.",
"properties": {
"doc_type": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Document types, e.g. bill, opinion, code_section, constitution_provision, meeting_transcript, amendment.",
"title": "Doc Type"
},
"level": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Levels of government: federal, state, county, municipal, consolidated, school_district, regional.",
"title": "Level"
},
"branch": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Branches: legislative, executive, judicial.",
"title": "Branch"
},
"body": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Issuing bodies by id, e.g. ga-supreme-court, ga-senate, ga-house-rules (describe_site lists them).",
"title": "Body"
},
"body_type": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Kinds of body: legislative_chamber, legislative_committee, court, board_of_education, governing_body, ...",
"title": "Body Type"
},
"place": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "A Georgia place in words or as an id (Atlanta, Cobb County, city:savannah). Matches the body's jurisdiction.",
"title": "Place"
},
"include_overlapping": {
"default": true,
"description": "With place: also bodies whose area overlaps it (Fulton and DeKalb for Atlanta).",
"title": "Include Overlapping",
"type": "boolean"
},
"place_scope": {
"default": "either",
"description": "With place: documents issued for that place (jurisdiction), documents that mention it (mentions), or either (default).",
"enum": [
"either",
"jurisdiction",
"mentions"
],
"title": "Place Scope",
"type": "string"
},
"date_from": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Earliest date: YYYY, YYYY-MM, or YYYY-MM-DD.",
"title": "Date From"
},
"date_to": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Latest date: YYYY, YYYY-MM, or YYYY-MM-DD.",
"title": "Date To"
},
"date_field": {
"anyOf": [
{
"enum": [
"date_primary",
"date_filed",
"date_met",
"date_adopted",
"date_effective"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Which date the range applies to; defaults to each type's own (filing date for opinions, meeting date for meetings).",
"title": "Date Field"
},
"session": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Legislative session slug, e.g. 2025-2026 or 2026-special.",
"title": "Session"
},
"status": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Status classes: pending, passed_one_chamber, passed_both, enacted, vetoed, failed, in_force, repealed, decided, held.",
"title": "Status"
},
"action": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Stage of an action inside a meeting: reading, motion, vote, adopted, failed, public_comment, ...",
"title": "Action"
}
},
"title": "Filters",
"type": "object"
}
},
"title": "searchArguments"
}