{
  "type": "object",
  "properties": {
    "corpusType": {
      "type": "string",
      "description": "Board's corpus_type (e.g. `state`, `state_regulation`, `federal_register`, `agency_guidance`), matched case-insensitively so `USC` / `CFR` work too. Call list_boards for the authoritative list: this is a growing set, not a fixed enum, and not every corpus is a watchable board.",
      "examples": [
        "state"
      ]
    },
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "enum": [
        "federal",
        "al",
        "ak",
        "az",
        "ar",
        "ca",
        "co",
        "ct",
        "de",
        "dc",
        "fl",
        "ga",
        "hi",
        "id",
        "il",
        "in",
        "ia",
        "ks",
        "ky",
        "la",
        "me",
        "md",
        "ma",
        "mi",
        "mn",
        "ms",
        "mo",
        "mt",
        "ne",
        "nv",
        "nh",
        "nj",
        "nm",
        "ny",
        "nc",
        "nd",
        "oh",
        "ok",
        "or",
        "pa",
        "pr",
        "ri",
        "sc",
        "sd",
        "tn",
        "tx",
        "ut",
        "vt",
        "va",
        "wa",
        "wv",
        "wi",
        "wy"
      ],
      "description": "Board's state, 2-letter and case-insensitive. For a federal board (USC, eCFR, the Federal Register) pass `federal` or omit entirely; the two are equivalent. Must otherwise match the `state` list_boards returned for this corpusType.",
      "examples": [
        "wa"
      ]
    },
    "channel": {
      "type": "string",
      "enum": [
        "webhook",
        "email",
        "both"
      ],
      "default": "webhook"
    },
    "webhookUrl": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Required when channel is webhook or both."
    },
    "webhookSecret": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Optional signing secret, stored encrypted and never returned. Every delivery then carries `X-Vaquill-Signature: sha256=<hex>`, an HMAC-SHA256 of the raw request body bytes keyed with this secret. Verify over the raw body before parsing JSON, constant-time."
    },
    "emailAddress": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Required when channel is email or both."
    },
    "scope": {
      "anyOf": [
        {
          "additionalProperties": {
            "type": "string"
          },
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "description": "Narrow the alert to one citation instead of a whole source. Three mutually exclusive forms. Hierarchy prefix: `{\"title\": \"21\", \"part\": \"314\"}`, where every level set must match and `title` is required whenever a narrower level is set. Exact section: `{\"actId\": \"CFR_T21_P314_S314_50\"}`, validated at create time and the only form EVERY source accepts, including flat ones. Named source: `{\"source\": \"fdic_fil\"}`, accepted on `agency_guidance`, `agency_manuals` and `cfr` only. Omit to watch the whole source.",
      "examples": [
        {
          "part": "314",
          "title": "21"
        }
      ]
    },
    "webhookAuth": {
      "anyOf": [
        {
          "properties": {
            "scheme": {
              "type": "string",
              "enum": [
                "none",
                "bearer",
                "basic",
                "header"
              ],
              "description": "`bearer` sends `Authorization: Bearer <secret>`. `basic` sends `Authorization: Basic <secret>` with the secret already base64-encoded by you. `header` sends `<headerName>: <secret>`, for gateways that read something like `X-Api-Key`. `none` removes any credential currently stored.",
              "default": "none"
            },
            "secret": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "The credential value. Stored encrypted and never returned. Required when setting a scheme for the first time or changing scheme; on PATCH you may omit it to keep the stored one while changing only `headerName`."
            },
            "headerName": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Header to send the credential on. Required for `header`, and rejected for every other scheme. Cannot be `Authorization` (use `bearer`/`basic`), a transport header, or one of ours.",
              "examples": [
                "X-Api-Key"
              ]
            }
          },
          "type": "object",
          "description": "How a delivery should authenticate itself to your endpoint.\n\nSEPARATE FROM `webhookSecret`, and the distinction is the point.\n`webhookSecret` signs the body so you can prove it is intact and ours.\nThis sends a credential so your gateway can reject anything else before\nit reaches your handler. Most integrations want the second, many want\nboth, and the two are set independently."
        },
        {
          "type": "null"
        }
      ],
      "description": "Optional outbound credential sent on every delivery, so your gateway can authenticate us with the header it already reads. Independent of `webhookSecret`: set neither, either, or both. Only valid on a webhook or both channel watch."
    }
  },
  "required": [
    "corpusType"
  ]
}

{
  "type": "object",
  "properties": {
    "watch_id": {
      "type": "string"
    }
  },
  "required": [
    "watch_id"
  ]
}

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {},
  "required": []
}

{
  "type": "object",
  "properties": {
    "act_id": {
      "type": "string",
      "maxLength": 200,
      "minLength": 3,
      "description": "Section identifier, e.g. `USC_T42_C21_S1983` (Title 42, Chapter 21, Section 1983, written 42 U.S.C. 1983). Take it from a search result rather than assembling it: the title and section are derivable from a citation but the CHAPTER is not, so hand-built ids usually 404.",
      "examples": [
        "CFR_T21_P314_S314_50"
      ]
    },
    "limit": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1,
      "description": "Max changes to return on this page.",
      "default": 50,
      "examples": [
        50
      ]
    },
    "sinceId": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "description": "Return only changes with an `id` greater than this: the cursor for polling forward into new changes. Ids are a monotonic sequence, so this is exact, immune to clock skew, and cannot drop two changes that share a timestamp. Carry `cursor` forward."
    },
    "beforeId": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "description": "Return only changes with an `id` less than this: the cursor for walking BACK through history, which is what a newest-first reader needs. Pass the smallest `id` on your last page."
    },
    "changeKind": {
      "anyOf": [
        {
          "items": {
            "type": "string",
            "enum": [
              "added",
              "amended",
              "removed"
            ]
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "description": "Filter to these kinds. Repeat the parameter to pass several (`?changeKind=amended&changeKind=removed`). Omit for all three."
    },
    "order": {
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ],
      "description": "`desc` (default) is newest first, the natural reading order for a history. Use `asc` to replay a section's life forward, or when catching up from a cursor.",
      "default": "desc"
    }
  },
  "required": [
    "act_id"
  ]
}

{
  "type": "object",
  "properties": {
    "act_id": {
      "type": "string",
      "maxLength": 200,
      "minLength": 3,
      "description": "Section identifier, e.g. `USC_T42_C21_S1983` (Title 42, Chapter 21, Section 1983, written 42 U.S.C. 1983). Take it from a search result rather than assembling it: the title and section are derivable from a citation but the CHAPTER is not, so hand-built ids usually 404.",
      "examples": [
        "USC_T42_C21_S1983"
      ]
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum citing sections to return.",
      "default": 25,
      "examples": [
        25
      ]
    }
  },
  "required": [
    "act_id"
  ]
}

{
  "type": "object",
  "properties": {
    "act_id": {
      "type": "string",
      "maxLength": 200,
      "minLength": 3,
      "description": "Section identifier, e.g. `USC_T42_C21_S1983` (Title 42, Chapter 21, Section 1983, written 42 U.S.C. 1983). Take it from a search result rather than assembling it: the title and section are derivable from a citation but the CHAPTER is not, so hand-built ids usually 404.",
      "examples": [
        "USC_T42_C21_S1983"
      ]
    },
    "limit": {
      "type": "integer",
      "maximum": 25,
      "minimum": 1,
      "description": "Maximum states to return, one provision each.",
      "default": 5,
      "examples": [
        5
      ]
    }
  },
  "required": [
    "act_id"
  ]
}

{
  "type": "object",
  "properties": {
    "act_id": {
      "type": "string",
      "maxLength": 200,
      "minLength": 3,
      "description": "Section identifier, e.g. `USC_T42_C21_S1983` (Title 42, Chapter 21, Section 1983, written 42 U.S.C. 1983). Take it from a search result rather than assembling it: the title and section are derivable from a citation but the CHAPTER is not, so hand-built ids usually 404.",
      "examples": [
        "USC_T42_C21_S1983"
      ]
    }
  },
  "required": [
    "act_id"
  ]
}

{
  "type": "object",
  "properties": {
    "act_id": {
      "type": "string",
      "maxLength": 200,
      "minLength": 3,
      "description": "Section identifier, e.g. `USC_T42_C21_S1983` (Title 42, Chapter 21, Section 1983, written 42 U.S.C. 1983). Take it from a search result rather than assembling it: the title and section are derivable from a citation but the CHAPTER is not, so hand-built ids usually 404.",
      "examples": [
        "USC_T42_C21_S1983"
      ]
    },
    "limit": {
      "type": "integer",
      "maximum": 10,
      "minimum": 1,
      "description": "How many sections to return on EACH side.",
      "default": 3,
      "examples": [
        3
      ]
    }
  },
  "required": [
    "act_id"
  ]
}

{
  "type": "object",
  "properties": {
    "actIds": {
      "items": {
        "type": "string"
      },
      "type": "array",
      "maxItems": 50,
      "minItems": 1,
      "description": "Section identifiers from a prior search, up to 50 per call. Duplicates are collapsed and order is preserved. DO NOT BUILD THESE FROM A CITATION: the chapter/article segments exist only in the data, so assembled ids miss. To start from a citation, use resolve_statute_citation.",
      "examples": [
        [
          "USC_T42_C21_S1983",
          "CFR_T17_P240_S240_10b5_1"
        ]
      ]
    }
  },
  "required": [
    "actIds"
  ]
}

{
  "type": "object",
  "properties": {
    "act_id": {
      "type": "string",
      "maxLength": 200,
      "minLength": 3,
      "description": "Section identifier, e.g. `USC_T42_C21_S1983` (Title 42, Chapter 21, Section 1983, written 42 U.S.C. 1983). Take it from a search result rather than assembling it: the title and section are derivable from a citation but the CHAPTER is not, so hand-built ids usually 404.",
      "examples": [
        "USC_T42_C21_S1983"
      ]
    }
  },
  "required": [
    "act_id"
  ]
}

{
  "type": "object",
  "properties": {
    "act_id": {
      "type": "string",
      "maxLength": 200,
      "minLength": 3,
      "description": "Section identifier, e.g. `USC_T42_C21_S1983` (Title 42, Chapter 21, Section 1983, written 42 U.S.C. 1983). Take it from a search result rather than assembling it: the title and section are derivable from a citation but the CHAPTER is not, so hand-built ids usually 404.",
      "examples": [
        "CFR_T17_P240_S240_10b5_1"
      ]
    },
    "format": {
      "type": "string",
      "enum": [
        "both",
        "html",
        "plain"
      ],
      "description": "Which representations to return. A long section carries the same text twice by default, so `plain` or `html` roughly halves the payload. Cost is unchanged: the fetch is the same either way.",
      "default": "both",
      "examples": [
        "plain"
      ]
    },
    "structured": {
      "type": "boolean",
      "description": "When true, also return `markdown` and a `subsections` tree parsed from the text for pincite addressing. Same cost.",
      "default": false,
      "examples": [
        true
      ]
    },
    "asOf": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
        },
        {
          "type": "null"
        }
      ],
      "description": "Return the section's text as it stood on this date (`YYYY-MM-DD`) instead of today's. Same cost.\n\n**This is a reconstruction, not an archive.** The corpus holds one current text per citation; an earlier one is rebuilt from the before-side of the first change we OBSERVED after your date. The `asOf` block on the response says which version you got (`source`), what it rests on (`basisChangeId`), how far back the evidence reaches (`observedFrom`), and whether the answer is bounded by when capture began rather than by the law (`isBounded`). Read `isBounded` before citing the text.\n\nA section that did not exist yet returns `available: false` with `asOf.existed: false`, which is a real answer and is charged. A section we know changed but cannot rebuild returns `source: \"unavailable\"` and IS refunded, because you asked for a historical text and did not get one.",
      "examples": [
        "2026-01-15"
      ]
    }
  },
  "required": [
    "act_id"
  ]
}

{
  "type": "object",
  "properties": {
    "watch_id": {
      "type": "string"
    },
    "change_id": {
      "type": "integer"
    }
  },
  "required": [
    "watch_id",
    "change_id"
  ]
}

{
  "type": "object",
  "properties": {
    "corpusType": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Only boards for this corpus type, matched case-insensitively so the uppercase spelling used by the statutes endpoints (`CFR`) finds the board (`cfr`). An unknown value is an empty page with `total: 0`, not an error.",
      "examples": [
        "state_regulation"
      ]
    },
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "enum": [
        "federal",
        "al",
        "ak",
        "az",
        "ar",
        "ca",
        "co",
        "ct",
        "de",
        "dc",
        "fl",
        "ga",
        "hi",
        "id",
        "il",
        "in",
        "ia",
        "ks",
        "ky",
        "la",
        "me",
        "md",
        "ma",
        "mi",
        "mn",
        "ms",
        "mo",
        "mt",
        "ne",
        "nv",
        "nh",
        "nj",
        "nm",
        "ny",
        "nc",
        "nd",
        "oh",
        "ok",
        "or",
        "pa",
        "pr",
        "ri",
        "sc",
        "sd",
        "tn",
        "tx",
        "ut",
        "vt",
        "va",
        "wa",
        "wv",
        "wi",
        "wy"
      ],
      "description": "Only boards for this jurisdiction. Pass `federal` for the boards that have no state (USC, eCFR, the Federal Register). Omit for no jurisdiction filter -- which is NOT the same as `federal`.",
      "examples": [
        "tx"
      ]
    },
    "limit": {
      "type": "integer",
      "maximum": 500,
      "minimum": 1,
      "description": "Max boards to return. The default covers the whole registry today; check `total` rather than assuming it always will.",
      "default": 500
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "description": "Number of boards to skip, for paging.",
      "default": 0
    }
  },
  "required": []
}

{
  "type": "object",
  "properties": {
    "corpusType": {
      "type": "string",
      "enum": [
        "USC",
        "CFR",
        "STATE",
        "REGULATION"
      ],
      "description": "Corpus to browse: USC, CFR, STATE, or REGULATION.",
      "examples": [
        "USC"
      ]
    },
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "enum": [
        "al",
        "ak",
        "az",
        "ar",
        "ca",
        "co",
        "ct",
        "de",
        "dc",
        "fl",
        "ga",
        "hi",
        "id",
        "il",
        "in",
        "ia",
        "ks",
        "ky",
        "la",
        "me",
        "md",
        "ma",
        "mi",
        "mn",
        "ms",
        "mo",
        "mt",
        "ne",
        "nv",
        "nh",
        "nj",
        "nm",
        "ny",
        "nc",
        "nd",
        "oh",
        "ok",
        "or",
        "pa",
        "pr",
        "ri",
        "sc",
        "sd",
        "tn",
        "tx",
        "ut",
        "vt",
        "va",
        "wa",
        "wv",
        "wi",
        "wy"
      ],
      "description": "2-letter jurisdiction code, required for STATE and REGULATION. Case-insensitive.",
      "examples": [
        "tx"
      ]
    },
    "titleNumber": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 1
        },
        {
          "type": "null"
        }
      ],
      "description": "USC/CFR title number to drill into.",
      "examples": [
        42
      ]
    },
    "code": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "State code identifier, e.g. `tx_pe` (browse `/us/statutes/divisions` with `corpusType=STATE&state=<code>` to list them).",
      "examples": [
        "tx_pe"
      ]
    },
    "chapter": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Chapter identifier to drill into (USC and state codes).",
      "examples": [
        "21"
      ]
    },
    "part": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Part identifier to drill into (CFR).",
      "examples": [
        "240"
      ]
    }
  },
  "required": [
    "corpusType"
  ]
}

{
  "type": "object",
  "properties": {},
  "required": []
}

{
  "type": "object",
  "properties": {
    "watch_id": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1,
      "description": "Max changes to return.",
      "default": 50
    },
    "sinceId": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "description": "Return only changes with an `id` greater than this. The cursor to build on: ids are a monotonic sequence, so this is exact, immune to clock skew, and cannot drop two changes that share a timestamp. Carry `meta.cursor` forward from your last page."
    },
    "beforeId": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "description": "Return only changes with an `id` below this: the cursor for walking BACK through history, where `sinceId` walks forward into new ones. Pass the smallest `id` on your last page."
    },
    "since": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Return only changes detected strictly after this ISO-8601 timestamp. Coarser than `sinceId` (a single refresh writes many rows at the same instant), but useful when all you kept was the `detectedAt` from a webhook body. Both may be combined.",
      "examples": [
        "2026-08-07T04:10:00Z"
      ]
    },
    "changeKind": {
      "anyOf": [
        {
          "items": {
            "type": "string",
            "enum": [
              "added",
              "amended",
              "removed"
            ]
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "description": "Filter to these kinds. Repeat the parameter to pass several (`?changeKind=added&changeKind=amended`). Omit for all three."
    },
    "order": {
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ],
      "description": "`desc` (default) is newest first, for showing a recent-activity list. Use `asc` when catching up from a cursor: walking forward means a page that hits `limit` leaves the gap at a known end.",
      "default": "desc"
    }
  },
  "required": [
    "watch_id"
  ]
}

{
  "type": "object",
  "properties": {
    "watch_id": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1,
      "description": "Max deliveries to return.",
      "default": 50
    }
  },
  "required": [
    "watch_id"
  ]
}

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1,
      "description": "Max watches to return.",
      "default": 100
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "description": "Number of watches to skip, for paging.",
      "default": 0
    }
  },
  "required": []
}

{
  "type": "object",
  "properties": {
    "cite": {
      "type": "string",
      "maxLength": 200,
      "minLength": 2,
      "description": "A Bluebook citation string, e.g. '42 U.S.C. 1983' or '16 C.F.R. 444.1'.",
      "examples": [
        "42 U.S.C. 1983"
      ]
    },
    "state": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 2,
          "minLength": 2
        },
        {
          "type": "null"
        }
      ],
      "description": "Optional 2-letter jurisdiction to resolve WITHIN, e.g. `tx`. Some citation forms are shared: `8 CCR 1206-2` is Colorado and `22 CCR 76227` is California. A constraint, not a hint: a citation naming a different jurisdiction returns `resolved: false` rather than being forced into this one.",
      "examples": [
        "tx"
      ]
    },
    "corpusType": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Optional corpus to resolve WITHIN: `STATE`, `REGULATION`, `STATE_RULES`, `CONSTITUTION`, `STATE_CONSTITUTION`. Narrows a citation whose form several corpora share; like `state`, a citation belonging to another corpus resolves to nothing instead.",
      "examples": [
        "REGULATION"
      ]
    }
  },
  "required": [
    "cite"
  ]
}

{
  "type": "object",
  "properties": {
    "citations": {
      "items": {
        "type": "string"
      },
      "type": "array",
      "minItems": 1,
      "description": "Bluebook citation strings, up to 50 per call. Duplicates are collapsed and order preserved, so `results` lines up with the de-duplicated input. Priced PER CITATION at the single-resolve rate: batching is a round-trip and latency win, not a discount.",
      "examples": [
        [
          "42 U.S.C. 1983",
          "16 C.F.R. 444.1",
          "Cal. Civ. Code 1950.5"
        ]
      ]
    },
    "state": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 2,
          "minLength": 2
        },
        {
          "type": "null"
        }
      ],
      "description": "Optional two-letter jurisdiction to resolve every citation WITHIN. Applies to the whole batch: a batch spanning jurisdictions should omit it and let each citation name its own. Same semantics as the single-citation route -- a constraint, not a hint.",
      "examples": [
        "ca"
      ]
    },
    "corpusType": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Optional corpus to resolve every citation WITHIN: `STATE`, `REGULATION`, `STATE_RULES`, `CONSTITUTION`, `STATE_CONSTITUTION`.",
      "examples": [
        "REGULATION"
      ]
    }
  },
  "required": [
    "citations"
  ]
}

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 500,
      "minLength": 2,
      "description": "Search query in natural language.",
      "examples": [
        "insider trading penalties"
      ]
    },
    "corpusType": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "USC",
            "CFR",
            "STATE",
            "CONSTITUTION",
            "FEDERAL_RULES",
            "STATE_CONSTITUTION",
            "STATE_RULES",
            "EXECUTIVE_ACTION",
            "REGULATION",
            "FEDERAL_REGISTER",
            "AGENCY_GUIDANCE",
            "SENTENCING_GUIDELINES",
            "US_TAX_TREATY",
            "STATE_AGENCY_GUIDANCE",
            "SESSION_LAW"
          ]
        },
        {
          "items": {
            "type": "string",
            "enum": [
              "USC",
              "CFR",
              "STATE",
              "CONSTITUTION",
              "FEDERAL_RULES",
              "STATE_CONSTITUTION",
              "STATE_RULES",
              "EXECUTIVE_ACTION",
              "REGULATION",
              "FEDERAL_REGISTER",
              "AGENCY_GUIDANCE",
              "SENTENCING_GUIDELINES",
              "US_TAX_TREATY",
              "STATE_AGENCY_GUIDANCE",
              "SESSION_LAW"
            ]
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "description": "Restrict to one corpus, or several as a list. Federal: `USC`, `CFR`, `CONSTITUTION`, `FEDERAL_RULES`, `FEDERAL_REGISTER`, `EXECUTIVE_ACTION`, `SENTENCING_GUIDELINES`, `US_TAX_TREATY`, `SESSION_LAW` (Statutes at Large, as enacted). Pair with `state`: `STATE`, `REGULATION`, `STATE_RULES`, `STATE_CONSTITUTION`, `STATE_AGENCY_GUIDANCE`. Omit for all.",
      "examples": [
        "CFR"
      ]
    },
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "enum": [
        "federal",
        "al",
        "ak",
        "az",
        "ar",
        "ca",
        "co",
        "ct",
        "de",
        "dc",
        "fl",
        "ga",
        "hi",
        "id",
        "il",
        "in",
        "ia",
        "ks",
        "ky",
        "la",
        "me",
        "md",
        "ma",
        "mi",
        "mn",
        "ms",
        "mo",
        "mt",
        "ne",
        "nv",
        "nh",
        "nj",
        "nm",
        "ny",
        "nc",
        "nd",
        "oh",
        "ok",
        "or",
        "pa",
        "pr",
        "ri",
        "sc",
        "sd",
        "tn",
        "tx",
        "ut",
        "vt",
        "va",
        "wa",
        "wv",
        "wi",
        "wy"
      ],
      "description": "Jurisdiction. A 2-letter code for one of the 52 supported US jurisdictions (50 states + DC + PR), or `federal` for USC / CFR / Constitution / federal rules. Pass a list to search several at once. Case-insensitive. Omit to search every jurisdiction.",
      "examples": [
        "ca"
      ]
    },
    "code": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "description": "Restrict to specific state statutory codes, e.g. `tx_pe` for the Texas Penal Code. Values are the `actId`s from list_statute_divisions. List allowed, across states. The only way to scope below a whole jurisdiction: `state=tx` alone searches all ~15 Texas codes.",
      "examples": [
        "tx_pe"
      ]
    },
    "yearFrom": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 2100,
          "minimum": 1700
        },
        {
          "type": "null"
        }
      ],
      "description": "Only sections last amended in or after this year; pair with `yearTo` for a window. Tracks the publisher's own amendment credit, not when we rebuilt the corpus. About a fifth of sections carry no credit and are excluded once either bound is set.",
      "examples": [
        2020
      ]
    },
    "yearTo": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 2100,
          "minimum": 1700
        },
        {
          "type": "null"
        }
      ],
      "description": "Only sections last amended in or before this year. This filters the LAST amendment, so a section amended in 2025 is excluded by `yearTo=2024` even though it existed in 2024. A currency filter, not point-in-time retrieval.",
      "examples": [
        2026
      ]
    },
    "excludeRepealed": {
      "type": "boolean",
      "description": "Drop sections whose own status says they are not operative (repealed, renumbered, transferred, expired, superseded, omitted, and the rest). Removes what we KNOW is dead; it does not promise the remainder is good law. Read `goodLawStatus` per result to tell them apart: `good_law` is checked, `unknown` is unchecked.",
      "default": false,
      "examples": [
        true
      ]
    },
    "actStatus": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "enum": [
        "abolished",
        "deleted",
        "expired",
        "in_force",
        "inactive",
        "not_funded",
        "not_yet_effective",
        "omitted",
        "proposed",
        "recodified",
        "recompiled",
        "rejected",
        "relocated",
        "removed",
        "renumbered",
        "repealed",
        "rescinded",
        "reserved",
        "revoked",
        "superseded",
        "terminated",
        "transferred",
        "unconstitutional",
        "vacant",
        "vetoed",
        "withdrawn"
      ],
      "description": "Positively scope to raw publisher statuses: `repealed` for dead law only, `in_force` for sections affirmatively marked current. The inverse of `excludeRepealed`, and what a compliance diff asking what was LOST needs. Combining a dead status with `excludeRepealed: true` is rejected 422.",
      "examples": [
        "repealed"
      ]
    },
    "changedSince": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
        },
        {
          "type": "null"
        }
      ],
      "description": "Only sections we OBSERVED changing on or after this date (`YYYY-MM-DD`). Observed, not effective: the date we saw it, an upper bound on when it took effect. Capture began long after the corpus did and events sweep at 24 months, so empty means no captured change, never that nothing was amended.",
      "examples": [
        "2026-08-01"
      ]
    },
    "agency": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "description": "Federal Register agency slug, e.g. `environmental-protection-agency`. Pass a list to match any of several. Applies to `FEDERAL_REGISTER` and `EXECUTIVE_ACTION`; other corpora carry no agency, so combining this with them returns nothing.",
      "examples": [
        "environmental-protection-agency"
      ]
    },
    "documentType": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "final",
            "proposed",
            "presidential"
          ]
        },
        {
          "type": "null"
        }
      ],
      "description": "Federal Register document stage: `final` (a rule in force), `proposed` (an NPRM), or `presidential` (a Presidential Document, the `EXECUTIVE_ACTION` corpus). Previously visible only as an `actId` prefix (`FR_RULE_` vs `FR_PRORULE_`) with no way to filter.",
      "examples": [
        "final"
      ]
    },
    "publishedFrom": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
        },
        {
          "type": "null"
        }
      ],
      "description": "Only return Federal Register documents published on or after this date (`YYYY-MM-DD`). This is the PUBLICATION date, which is not the same as `yearFrom`: that filters the version year of a section.",
      "examples": [
        "2024-01-01"
      ]
    },
    "publishedTo": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
        },
        {
          "type": "null"
        }
      ],
      "description": "Only return Federal Register documents published on or before this date.",
      "examples": [
        "2024-12-31"
      ]
    },
    "titleNumber": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "description": "Filter by USC/CFR title number (e.g., 17 for SEC, 42 for civil rights). Only meaningful for `USC`/`CFR`; ignored for state corpora whose titles are alphabetic (e.g. Texas `pe` = Penal Code).",
      "examples": [
        17
      ]
    },
    "chapter": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "description": "One or more chapters within a title or code, e.g. `21` for USC Title 42 Chapter 21. Pass a hit's `parent.chapter` back to search its neighbors. Chapter numbers repeat across titles, so pair with `titleNumber` (USC) or `code` (state); an unpaired chapter is rejected.",
      "examples": [
        "21"
      ]
    },
    "part": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "description": "One or more parts within a title, e.g. `240` for 17 C.F.R. Part 240. The CFR counterpart to `chapter`: pass a hit's `parent.part` back. Pair with `titleNumber`; an unpaired part is rejected.",
      "examples": [
        "240"
      ]
    },
    "source": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "enum": [
        "administrative_guidance",
        "agency_guidance",
        "bis_advisory_opinion",
        "cftc_staff_letter",
        "copyright_circular",
        "cpsc_advisory_opinion",
        "cpsc_secg",
        "ddtc_commodity_jurisdiction",
        "ddtc_guidance",
        "dfars",
        "dfars_pgi",
        "doe_appliance_guidance",
        "doj_justice_manual",
        "doj_leniency",
        "far",
        "fcc_declaratory_ruling",
        "fdic_fil",
        "ferc_policy_statement",
        "fincen_guidance",
        "fincen_ruling",
        "frap",
        "frb_sr_letter",
        "frbp",
        "frcp",
        "frcrp",
        "fre",
        "hhs_ocr_hipaa_faq",
        "hhs_ocr_hipaa_guidance",
        "hhs_ocr_resolution_agreement",
        "irs_announcement",
        "irs_notice",
        "irs_rev_proc",
        "irs_rev_rul",
        "merger_guidelines",
        "mpep",
        "nlrb_advice_memo",
        "nlrb_gc_memo",
        "occ_bulletin",
        "occ_interpretive_letter",
        "sct",
        "ssa_ruling",
        "state_insurance_bulletin",
        "tmep",
        "us_tax_treaty",
        "us_tax_treaty_technical_explanation",
        "uscis_policy_manual"
      ],
      "description": "The named body of law within a `corpusType` that folds several together: `FEDERAL_RULES` into `frcp`/`fre`/`sct`, `CFR` into `far`/`dfars`, `AGENCY_GUIDANCE` into ~34 agency sources. Every result carries its own `source`, so a hit's value can be passed straight back.",
      "examples": [
        "sct"
      ]
    },
    "fields": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array",
          "uniqueItems": true
        },
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "enum": [
        "abstract",
        "actId",
        "actStatus",
        "action",
        "adoptingCitations",
        "agencies",
        "agencySlugs",
        "alternateCitations",
        "amendmentHistory",
        "amendmentNote",
        "amendmentYears",
        "amendmentsCount",
        "articleName",
        "articleNumber",
        "audience",
        "breadcrumb",
        "caseName",
        "chapter",
        "chapterName",
        "citation",
        "citationShort",
        "committeeNote",
        "corpusType",
        "crossReferencesCfr",
        "crossReferencesUsc",
        "currencyNote",
        "currencyYear",
        "currentThrough",
        "datesText",
        "displayLabel",
        "displayPath",
        "documentNumber",
        "documentSubtype",
        "documentTypeLabel",
        "docxUrl",
        "edition",
        "effectiveDate",
        "excerpt",
        "expirationDate",
        "externalUrl",
        "federalRegisterCitations",
        "frCommentsCloseOn",
        "frCorrectionOf",
        "frCorrections",
        "frDocketIds",
        "frEffectiveOn",
        "frEndPage",
        "frRegulationIdNumbers",
        "frRegulationsDotGovUrl",
        "frRelatedDocuments",
        "frSignificant",
        "frStartPage",
        "frVolume",
        "goodLawStatus",
        "govInfoHtmlUrl",
        "govInfoPdfUrl",
        "granuleId",
        "history",
        "htmlUrl",
        "implementingRegulations",
        "issueDate",
        "issuingAgency",
        "languageCode",
        "lastAmendedDate",
        "lastAmendedYear",
        "lawImplemented",
        "licenseNote",
        "originalEnactmentDate",
        "packageId",
        "parent",
        "part",
        "partName",
        "pdfUrl",
        "popularName",
        "president",
        "priorEffectiveDates",
        "program",
        "publicLawCites",
        "publicLaws",
        "publicationDate",
        "publisherKey",
        "referencedShortTitles",
        "relatedCitations",
        "releaseDate",
        "relevanceScore",
        "renumberedTo",
        "requesters",
        "rescindedOn",
        "reviewDate",
        "ruleSet",
        "ruleSetCode",
        "sectionNumber",
        "sectionTitle",
        "settlementAmount",
        "signingDate",
        "source",
        "sourceCharEnd",
        "sourceCharStart",
        "sourceCredit",
        "sourceNote",
        "sourcePageEnd",
        "sourcePageStart",
        "state",
        "stateHtmlUrl",
        "statutoryAuthority",
        "subchapter",
        "subchapterName",
        "subject",
        "subjectNumber",
        "subpart",
        "subpartName",
        "subtitle",
        "subtitleName",
        "supersededBy",
        "supersedes",
        "supersessionActions",
        "textUrl",
        "title",
        "titleName",
        "titleNumber",
        "topLevelTitle",
        "topics",
        "transferredTo",
        "versionId",
        "volume",
        "wordCount",
        "xmlUrl",
        "year"
      ],
      "description": "Return only these result fields, e.g. `[\"title\", \"excerpt\"]`. A result carries 40+ fields, most null on any given row. `actId` and `citation` are always included. Unknown names are rejected 422. Omit for the full object.",
      "examples": [
        [
          "title",
          "excerpt",
          "state"
        ]
      ]
    },
    "limit": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "Number of results to return per page.",
      "default": 10
    },
    "offset": {
      "type": "integer",
      "maximum": 70,
      "minimum": 0,
      "description": "How many results to skip, for paging. Every page of a query is cut from one ranking, so results never repeat or go missing between pages. The deepest reachable result is `offset` + `limit`; check `hasMore`.",
      "default": 0
    },
    "excerptChars": {
      "type": "integer",
      "maximum": 4000,
      "minimum": 100,
      "description": "Characters of matching text to include in each result's `excerpt`. The excerpt is a ranking preview; use `/us/statutes/section/{actId}/body` for the full text. Default 500.",
      "default": 500
    },
    "matchType": {
      "type": "string",
      "enum": [
        "any",
        "all",
        "phrase"
      ],
      "description": "`any` (default) is hybrid semantic + keyword ranking, for natural-language questions. `all` requires every query term; `phrase` matches an exact phrase, for a defined term. To pull up one section, pass its citation as the query and it resolves to that section at rank 1.",
      "default": "any",
      "examples": [
        "phrase"
      ]
    }
  },
  "required": [
    "query"
  ]
}

{
  "type": "object",
  "properties": {
    "watch_id": {
      "type": "string"
    }
  },
  "required": [
    "watch_id"
  ]
}

{
  "type": "object",
  "properties": {
    "watch_id": {
      "type": "string"
    },
    "isActive": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "description": "Pause (false) or resume (true) the watch."
    },
    "webhookUrl": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "New webhook URL. Only valid on a webhook/both channel watch. Re-validated against the SSRF blocklist. Cannot be cleared."
    },
    "webhookSecret": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "New signing secret, or empty string to stop signing deliveries. Only valid on a webhook/both channel watch."
    },
    "scope": {
      "anyOf": [
        {
          "additionalProperties": {
            "type": "string"
          },
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "description": "Replace the alert's narrowing. Three mutually exclusive forms. Hierarchy prefix: `{\"title\": \"21\", \"part\": \"314\"}`, where every level set must match and `title` is required whenever a narrower level is set. Exact section: `{\"actId\": \"CFR_T21_P314_S314_50\"}`, the only form EVERY source accepts. Named source: `{\"source\": \"fdic_fil\"}`, on `agency_guidance`, `agency_manuals` and `cfr` only. Omitting the field leaves the current scope unchanged.",
      "examples": [
        {
          "part": "314",
          "title": "21"
        }
      ]
    },
    "emailAddress": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "New email address. Only valid on an email/both channel watch. Cannot be cleared."
    },
    "webhookAuth": {
      "anyOf": [
        {
          "properties": {
            "scheme": {
              "type": "string",
              "enum": [
                "none",
                "bearer",
                "basic",
                "header"
              ],
              "description": "`bearer` sends `Authorization: Bearer <secret>`. `basic` sends `Authorization: Basic <secret>` with the secret already base64-encoded by you. `header` sends `<headerName>: <secret>`, for gateways that read something like `X-Api-Key`. `none` removes any credential currently stored.",
              "default": "none"
            },
            "secret": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "The credential value. Stored encrypted and never returned. Required when setting a scheme for the first time or changing scheme; on PATCH you may omit it to keep the stored one while changing only `headerName`."
            },
            "headerName": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Header to send the credential on. Required for `header`, and rejected for every other scheme. Cannot be `Authorization` (use `bearer`/`basic`), a transport header, or one of ours.",
              "examples": [
                "X-Api-Key"
              ]
            }
          },
          "type": "object",
          "description": "How a delivery should authenticate itself to your endpoint.\n\nSEPARATE FROM `webhookSecret`, and the distinction is the point.\n`webhookSecret` signs the body so you can prove it is intact and ours.\nThis sends a credential so your gateway can reject anything else before\nit reaches your handler. Most integrations want the second, many want\nboth, and the two are set independently."
        },
        {
          "type": "null"
        }
      ],
      "description": "Replace the outbound credential config, sent as a WHOLE object rather than field by field: a scheme without a credential is not a partial edit, it is a broken config. `{\"scheme\": \"none\"}` removes auth. Keeping the scheme and omitting `secret` retains the stored credential."
    }
  },
  "required": [
    "watch_id"
  ]
}