---
canonical_url: "https://docs.composio.dev/toolkits/vaquill"
markdown_url: "https://docs.composio.dev/toolkits/vaquill.md"
product: "platform"
version: null
last_updated: null
---

# Vaquill

Vaquill provides API access to US statutes, legal research, citation resolution, credit usage, and board-change watches.

- **Category:** legal & public records
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 31
- **Triggers:** 0
- **Slug:** `VAQUILL`
- **Version:** 20261014_00
- **Instant:** Supported on the latest version. Support varies by tool.

## Tools

### Browse Statute Divisions

**Slug:** `VAQUILL_BROWSE_STATUTE_DIVISIONS`

Browse one level of a statutory hierarchy at a time. Costs 1 credit per page.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.01 per API credit consumed

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `code` | string | No | State code or federal rule-set identifier returned by an earlier division listing. |
| `part` | string | No | CFR part identifier to drill into. |
| `state` | string ("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") | No | Two-letter jurisdiction code required for STATE, REGULATION, and STATE_CONSTITUTION corpora. |
| `article` | string | No | Constitution or state-code article identifier returned by an earlier division listing; pass it back exactly. |
| `chapter` | string | No | USC or state-code chapter identifier to drill into. |
| `act_status` | string ("abolished" | "deleted" | "expired" | "in_force" | "inactive" | "non_precedential" | "not_funded" | "not_yet_effective" | "omitted" | "proposed" | "recodified" | "recompiled" | "rejected" | "relocated" | "removed" | "renumbered" | "repealed" | "rescinded" | "reserved" | "revoked" | "superseded" | "terminated" | "transferred" | "unconstitutional" | "vacant" | "vacated" | "vetoed" | "withdrawn") | No | Return only sections carrying this raw publisher status. |
| `corpus_type` | string ("USC" | "CFR" | "STATE" | "REGULATION" | "CONSTITUTION" | "STATE_CONSTITUTION" | "FEDERAL_RULES") | Yes | Corpus hierarchy to browse. |
| `next_cursor` | string | No | Opaque continuation cursor returned by a previous call. Omit it for the first page and pass it back unchanged. |
| `title_number` | integer | No | USC or CFR title number to drill into. |
| `exclude_repealed` | boolean | No | Exclude sections affirmatively marked repealed or otherwise inoperative. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Compare Statute Cross State

**Slug:** `VAQUILL_COMPARE_STATUTE_CROSS_STATE`

Find the top analogous statutory provisions in other states for one state statute section. Costs 6 credits and supports state-statute sections only.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.01 per API credit consumed

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum states to return, with at most one provision per state (1-25). |
| `act_id` | string | Yes | State-statute section ID returned by statute search or citation resolution. A resolvable citation also works but incurs the separate resolution charge. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Count Statute Sections

**Slug:** `VAQUILL_COUNT_STATUTE_SECTIONS`

Count exact sections in a legal corpus scope before enumeration. Costs 1 credit and does not perform text search.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.01 per API credit consumed

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `code` | string | No | One or more statutory code or federal rule-set identifiers. |
| `part` | string | No | One or more CFR part identifiers; pair with title_number. |
| `state` | string | No | One or more two-letter jurisdiction codes, or federal. |
| `article` | string | No | One or more article identifiers; pair each with its corpus, state, or code context. |
| `chapter` | string | No | One or more chapter identifiers; pair with title_number or code. |
| `act_status` | string | No | One or more raw publisher section status values to count. |
| `corpus_type` | string | No | One or more corpus types to count; omit to count every corpus. |
| `title_number` | integer | No | USC or CFR title number to constrain the count. |
| `exclude_repealed` | boolean | No | Exclude sections known to be repealed or otherwise inoperative. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Board Watch

**Slug:** `VAQUILL_CREATE_BOARD_WATCH`

Create an active email, webhook, or dual-channel watch that immediately begins monitoring a legal corpus source and may send future external email or webhook notifications until paused or deleted. Email works on every documented plan; webhook and both require Business. The watch cap is 3 outside Business and 100 on Business, and duplicate board/channel/scope combinations return a conflict.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `scope` | object | No | Optional narrowing. Choose exactly one hierarchy, act_id, source, or agency form; omit this field to watch the whole board. |
| `state` | string ("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") | No | Board jurisdiction. Use a two-letter state code for state-specific boards; federal boards may use federal or omit this field. |
| `channel` | string ("email" | "webhook" | "both") | No | Delivery channel. Email is available on every documented plan; webhook and both require Business. |
| `corpus_type` | string | Yes | Watchable corpus type returned by List Watchable Boards. |
| `webhook_url` | string | No | Public HTTPS destination required for webhook or both channels. Vaquill applies an SSRF blocklist at creation and delivery time. |
| `webhook_auth` | object | No | Optional outbound credential for webhook delivery. This is independent of webhook_secret and is valid only for webhook-capable channels. |
| `email_address` | string | No | Recipient required for email or both channels. |
| `webhook_secret` | string | No | Optional HMAC-SHA256 signing secret for webhook deliveries. Vaquill stores it encrypted and never returns it. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Board Watch

**Slug:** `VAQUILL_DELETE_BOARD_WATCH`

Permanently delete a board watch and all of its delivery history. This cannot be undone. Pause the watch instead when its configuration or history must be retained. This endpoint is free.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `watch_id` | string | Yes | Watch ID to permanently delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Adjacent Statute Sections

**Slug:** `VAQUILL_GET_ADJACENT_STATUTE_SECTIONS`

Get the immediately adjacent sections before and after a statute section in statutory order. Costs 2 credits.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.01 per API credit consumed

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Number of sections to return on each side; this endpoint has no second page. |
| `act_id` | string | Yes | Section ID whose statutory neighbors to return. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get API Credit Pricing

**Slug:** `VAQUILL_GET_API_CREDIT_PRICING`

Get Vaquill's live credit conversion, purchase bounds, and per-operation prices without authentication or credit consumption.

**Instant:** Supported on the latest version.

**Instant pricing:** $0 per request

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `region` | string ("US" | "IN") | No | Jurisdiction pricing to return: US for the United States primary-law surface or IN for the India legislation surface. Omit to let Vaquill select the pricing surface for the API documentation context. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Board Watch Change Diff

**Slug:** `VAQUILL_GET_BOARD_WATCH_CHANGE_DIFF`

Get complete old and new section text for one exact observed watch change. Call only for a change returned with has_diff=true. This is the alerts family's only metered route and normally costs 4 credits. Vaquill refunds the call when an amended change is missing either side, its resolved sides are identical, or no text resolves.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `watch_id` | string | Yes | Exact watch ID returned by Create Board Watch or List Board Watches. The requested change must be covered by this watch. |
| `change_id` | integer | Yes | Exact integer change ID returned by List Board Watch Changes for this watch. Call this action only when that change has_diff is true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Credit Balance

**Slug:** `VAQUILL_GET_CREDIT_BALANCE`

Get the connected Vaquill account's spendable credits, USD balance, expiries, plan, lifetime usage, and applied request limits. This read is free and does not consume credits.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Session Law

**Slug:** `VAQUILL_GET_SESSION_LAW`

Get complete metadata for one US state session law by provider ID or citation. An exact provider ID costs 2 credits; citation input may also incur Vaquill's separate citation-resolution surcharge.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.01 per API credit consumed

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `jurisdiction` | string ("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") | No | Optional state or territory code for resolving a citation that does not name its jurisdiction. It vetoes a conflicting citation jurisdiction and has no effect when session_law_id is a provider ID. |
| `session_law_id` | string | Yes | Provider-issued state session-law ID returned by a session-law list. A citation is also accepted and may incur Vaquill's citation-resolution surcharge; federal SAL_ IDs are not valid for this endpoint. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Session Law Body

**Slug:** `VAQUILL_GET_SESSION_LAW_BODY`

Get one page of a US state session law's text, with character offsets, text hash, and amendatory-markup metadata. Vaquill charges 6 credits per served page. Unavailable text is not charged; not-found, stale-cursor, and server failures are not charged or are refunded.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.01 per API credit consumed

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `start_char` | integer | No | Zero-based character offset at which to start a random-access page. Use expect_text_sha256 to bind this read to the text version you inspected. Cannot be combined with next_cursor. |
| `next_cursor` | string | No | Opaque continuation cursor returned by the previous body page. Omit it for the first page and pass it back unchanged. It is bound to the exact text version and cannot be combined with start_char. |
| `session_law_id` | string | Yes | Provider-issued state session-law ID returned by a session-law list. Use an exact ID rather than a citation; federal SAL_ IDs are not valid here. |
| `expect_text_sha256` | string | No | Lowercase hexadecimal prefix or full SHA-256 of the expected complete text (16-64 characters). Use with start_char so Vaquill rejects the read if the text was re-collected. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Session Laws Batch

**Slug:** `VAQUILL_GET_SESSION_LAWS_BATCH`

Get up to 50 distinct US state session laws by provider ID or citation. Vaquill charges 2 credits per law served; each citation also costs 2 resolution credits when a verdict is produced. include_body adds 6 credits per first body page served. Misses incur no batch-route charge. Validation errors are uncharged; provider 500/503 failures and resolution charges for session_not_fully_collected or lookup errors are refunded.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.01 per API credit consumed

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ids` | array | Yes | Provider-issued state session-law IDs or citations. The provider trims entries, drops blanks, and collapses exact duplicates in first-input order. Supply 1-200 raw entries and no more than 50 distinct nonblank values. IDs avoid citation-resolution charges. |
| `include_body` | boolean | No | Include the first approximately 30,000-character body page for each served law, adding 6 credits for every body page actually served. |
| `jurisdiction` | string ("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") | No | State or territory used to resolve citations for the whole batch. Ignored for provider-issued IDs. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Statute Body

**Slug:** `VAQUILL_GET_STATUTE_BODY`

Get full statute text in a selected format, optionally with a subsection tree or point-in-time reconstruction. Costs 6 credits when text is returned. Ordinary unavailable text and fetch failures are refunded. Historical available:false answers are charged when the section did not yet exist or a stored-edition date is outside held coverage; unavailable observed-change reconstructions are refunded.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.01 per API credit consumed

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `as_of` | string | No | Date whose observed or published text to reconstruct. Inspect as_of.engine and as_of.is_bounded before treating the result as authoritative historical law. |
| `act_id` | string | Yes | Section ID returned by statute search or citation resolution. A resolvable citation also works but incurs the separate citation-resolution charge. |
| `format` | string ("all" | "both" | "html" | "markdown" | "plain" | "content" | "operative") | No | Text representation to return. Use operative for the smallest USC payload, content to retain separately identified notes, or all for every available representation. Non-USC content and operative requests fall back to plain text. |
| `structured` | boolean | No | Include a parsed subsection tree and nested-list Markdown for pinpoint citation. This structured Markdown replaces table-preserving Markdown. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Statute Cited By

**Slug:** `VAQUILL_GET_STATUTE_CITED_BY`

Find the top USC and CFR sections that cite a statute section. Costs 2 credits; results are bounded by limit and are not pageable.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.01 per API credit consumed

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum top citing sections to return (1-100); this endpoint has no second page. |
| `act_id` | string | Yes | Section ID whose inbound USC and CFR citations to find. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Statute Definitions

**Slug:** `VAQUILL_GET_STATUTE_DEFINITIONS`

Get chapter definitions governing a statute section. Costs 4 credits; no-definition and failed lookups are refunded.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.01 per API credit consumed

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `act_id` | string | Yes | Section ID whose governing chapter definitions to return. Use an ID from statute search or citation resolution instead of constructing one. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Statute Enactments

**Slug:** `VAQUILL_GET_STATUTE_ENACTMENTS`

Get state session laws whose publisher affected-sections tables print this exact code section. This is not complete amendment history. Supported existing sections cost 1 credit, including empty answers; unsupported or missing sections and provider 500/503 failures are uncharged or refunded. Citation input adds the 2-credit resolution charge. Results are capped at the newest 200 with no continuation; inspect truncated and coverage.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.01 per API credit consumed

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `act_id` | string | Yes | Section ID returned by statute search or citation resolution. A citation is accepted but adds Vaquill's 2-credit resolution charge; do not construct an ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Statutes Coverage

**Slug:** `VAQUILL_GET_STATUTES_COVERAGE`

Return Vaquill's authoritative live jurisdiction and corpus coverage matrix before choosing statute search filters. This discovery call costs no credits.

**Instant:** Supported on the latest version.

**Instant pricing:** $0 per request

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Statute Section

**Slug:** `VAQUILL_GET_STATUTE_SECTION`

Get metadata and source links for one US statute section by canonical section ID or resolvable citation. Costs 2 credits for an exact ID; citation input also incurs Vaquill's citation-resolution charge.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.01 per API credit consumed

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `act_id` | string | Yes | Section ID returned by statute search or citation resolution. A resolvable citation also works but incurs the separate citation-resolution charge. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Statute Sections Batch

**Slug:** `VAQUILL_GET_STATUTE_SECTIONS_BATCH`

Get metadata for up to 50 statute sections in input order, with optional full text. Costs 2 credits per section returned, plus the ordinary body charge for each included body; unresolved identifiers are refunded.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.01 per API credit consumed

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `act_ids` | array | Yes | Section IDs returned by statute search, or resolvable citations, to retrieve in order. Do not construct section IDs from citations. Duplicates are collapsed while preserving first-input order. |
| `include_body` | boolean | No | Return full text in each section's body field when available. This adds the ordinary body charge for every body returned. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Board Watch Changes

**Slug:** `VAQUILL_LIST_BOARD_WATCH_CHANGES`

List sections observed as added, amended, or removed on a watched source. History is capture-bounded, retained for five years, and this call is free.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum change events in this page (1-200). |
| `order` | string ("asc" | "desc") | No | Sort order. Use asc for forward catch-up and desc for backward history. |
| `since` | string | No | Return changes detected strictly after this ISO-8601 timestamp. This is coarser than since_id but may be combined with it. |
| `since_id` | integer | No | Return changes with an ID greater than this value. The continuation cursor preserves this lower bound. |
| `watch_id` | string | Yes | Watch ID whose captured source changes to list. |
| `before_id` | integer | No | Return changes with an ID less than this value. The continuation cursor preserves this upper bound. |
| `change_kind` | array | No | Change kinds to include: added, amended, or removed. |
| `next_cursor` | string | No | Opaque continuation cursor returned by a previous call. Pass it back unchanged; its saved filters and integer bounds take precedence. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Board Watch Deliveries

**Slug:** `VAQUILL_LIST_BOARD_WATCH_DELIVERIES`

List the newest persisted webhook delivery attempts and current delivery health for a board watch. History is retained for 90 days and this bounded limit-only endpoint has no second page. Email-only watches return no attempts, and synthetic test deliveries are excluded. The read is free, but meaningful history requires a webhook or both-channel watch, which requires Vaquill Business.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum newest attempts to return (1-200, default 50). This is a bounded history read with no second page. |
| `watch_id` | string | Yes | Watch ID whose recent webhook delivery attempts to inspect. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Board Watches

**Slug:** `VAQUILL_LIST_BOARD_WATCHES`

List board watches owned by the connected Vaquill API-key account, including delivery destination, active state, and latest health metadata. Costs no credits.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum watches in this page (1-200). |
| `offset` | integer | No | Number of watches to skip on the first page. |
| `next_cursor` | string | No | Opaque continuation cursor returned by a previous call. Omit it for the first page and pass it back unchanged. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Session Law Changes

**Slug:** `VAQUILL_LIST_SESSION_LAW_CHANGES`

List one oldest-first page of changes to Vaquill's state session-law registry for incremental synchronization. Costs 1 credit per page, including an empty page; validation failures are not charged and provider failures are refunded.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.01 per API credit consumed

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum feed entries to return on this page (1-200). |
| `since_id` | integer | No | Return entries with an ID greater than this monotonic feed position. Use 0 for the beginning of the feed. |
| `next_cursor` | string | No | Opaque continuation cursor returned by a previous call. Pass it back unchanged; it restores the jurisdiction and limit and advances since_id. |
| `jurisdiction` | string ("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") | No | Limit changes to one state, DC, or Puerto Rico. Omit for every state jurisdiction; federal session laws are not in this feed. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Session Laws

**Slug:** `VAQUILL_LIST_SESSION_LAWS`

List one page of a state's session laws with session, date, text-availability, and instrument filters. Costs 1 credit per page. Empty pages are refunded when coverage reports a wholly partial or not-held collection; complete and partly complete jurisdiction pages are charged.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.01 per API credit consumed

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum session laws to return on this page (1-200). |
| `query` | string | No | Case-insensitive title or printed bill-number substring (3-100 characters). |
| `is_law` | boolean | No | Select enacted laws (true) or numbered measures that are not law (false). |
| `series` | array | No | Session-law numbering series to include, such as general or resolve. |
| `session` | string | No | Session code returned by Vaquill, such as 2025R. |
| `has_text` | boolean | No | Set true to return only laws whose text Vaquill serves. |
| `approved_to` | string | No | Inclusive latest approval date. |
| `next_cursor` | string | No | Opaque continuation cursor returned by a previous call. Omit it for the first page and pass it back unchanged. |
| `text_status` | string ("held" | "withheld" | "not_held" | "pending") | No | Text availability status to include. |
| `effective_to` | string | No | Include laws with an effective date on or before this date. |
| `jurisdiction` | string ("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") | Yes | State or territory whose session laws to list. |
| `approved_from` | string | No | Inclusive earliest approval date. |
| `updated_since` | string | No | Include records updated on or after this date, at midnight UTC. |
| `effective_from` | string | No | Include laws with an effective date on or after this date. |
| `instrument_type` | array | No | Kinds of measure to include, such as act or resolve. |
| `enactment_outcome` | array | No | Enactment outcomes to include. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Statute Changes

**Slug:** `VAQUILL_LIST_STATUTE_CHANGES`

List capture-bounded observed change history for a statute section. This is not complete legislative history. Costs 1 credit per page.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.01 per API credit consumed

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum change events in this page. |
| `order` | string ("asc" | "desc") | No | Chronological result order: asc or desc. |
| `act_id` | string | Yes | Section ID whose observed changes to return. |
| `since_id` | integer | No | Return events after this monotonic change ID for forward traversal. Requires ascending order, which is selected automatically when order is omitted. |
| `before_id` | integer | No | Return events before this monotonic change ID for backward traversal. Requires descending order. |
| `change_kind` | array | No | Change kinds to include: added, amended, or removed. |
| `next_cursor` | string | No | Opaque continuation cursor returned by a previous call. Pass it back unchanged and do not combine it with since_id or before_id. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Watchable Boards

**Slug:** `VAQUILL_LIST_WATCHABLE_BOARDS`

List corpus sources that can be watched, including freshness, polling cadence, retrieval health, and supported scope filters. Costs no credits.

**Instant:** Supported on the latest version.

**Instant pricing:** $0 per request

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum boards to return on this page (1-500). |
| `state` | string ("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") | No | Return only this jurisdiction. Use federal for sources without a state; omit for all jurisdictions. |
| `corpus_type` | string | No | Return only this corpus type; matching is case-insensitive. |
| `next_cursor` | string | No | Opaque continuation cursor returned by a previous call. Omit it for the first page and pass it back unchanged. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Resolve Statute Citation

**Slug:** `VAQUILL_RESOLVE_STATUTE_CITATION`

Resolve one Bluebook citation to an exact statute section. Costs 2 credits whether or not it resolves.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.01 per API credit consumed

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `state` | string ("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") | No | State code used to disambiguate the citation, or 'federal' for federal law. |
| `citation` | string | Yes | Bluebook-style citation to resolve. |
| `corpus_type` | string ("CONSTITUTION" | "REGULATION" | "STATE" | "STATE_CONSTITUTION" | "STATE_RULES") | No | Corpus type used to constrain resolution. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Resolve Statute Citations Batch

**Slug:** `VAQUILL_RESOLVE_STATUTE_CITATIONS_BATCH`

Resolve up to 50 unique Bluebook citations in one call from a raw list of up to 500 entries. Duplicates are collapsed, and each unique citation costs 2 credits.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.01 per API credit consumed

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `state` | string ("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") | No | Two-letter state code, or federal, used to constrain every citation. Omit this for a batch spanning jurisdictions. |
| `citations` | array | Yes | Bluebook-style citations to resolve. The raw list may contain 1-500 entries; Vaquill collapses duplicates in input order and accepts at most 50 unique citations. Each unique citation costs 2 credits. |
| `corpus_type` | string ("CONSTITUTION" | "REGULATION" | "STATE" | "STATE_CONSTITUTION" | "STATE_RULES") | No | Corpus type used to constrain every citation in the batch. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search US Statutes

**Slug:** `VAQUILL_SEARCH_US_STATUTES`

Search US statutes and regulations, constitutions and court rules, executive actions and Federal Register materials, agency guidance and adjudications, sentencing guidelines, tax treaties, and session laws with semantic and keyword matching. Costs 4 credits, plus 6 credits for each full body returned.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.01 per API credit consumed

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `code` | string | No | One or more statutory code identifiers returned by the divisions endpoint. |
| `part` | string | No | One or more CFR part identifiers; pair with title_number. |
| `limit` | integer | No | Maximum results in this page (1-50). |
| `query` | string | Yes | Legal concept, citation, or text to search for. |
| `state` | string | No | One or more two-letter state or jurisdiction codes, or federal. |
| `agency` | string | No | One or more agency slugs or unambiguous names for applicable corpora. |
| `fields` | array | No | Provider result fields to include; actId and citation are always returned. |
| `offset` | integer | No | Starting result offset. Prefer next_cursor for subsequent pages. |
| `source` | string | No | One or more source identifiers for corpora containing multiple bodies of law. |
| `article` | string | No | One or more article identifiers; include the required corpus, state, or code context. |
| `chapter` | string | No | One or more chapter identifiers; pair with title_number or code. |
| `year_to` | integer | No | Latest enactment, amendment, effective, or publication year to include. |
| `year_from` | integer | No | Earliest enactment, amendment, effective, or publication year to include. |
| `act_status` | string | No | One or more raw publisher section status values to include. |
| `match_type` | string ("any" | "all" | "phrase") | No | Use any for hybrid search, all for every query word, or phrase for words in order. |
| `corpus_type` | string | No | One or more corpus types from the live coverage matrix. |
| `next_cursor` | string | No | Opaque continuation cursor returned by a previous call. |
| `include_body` | boolean | No | Include full text at an additional 6 credits for each body returned. |
| `published_to` | string | No | Latest Federal Register publication date to include. |
| `title_number` | integer | No | USC or CFR title number to constrain the search. |
| `changed_since` | string | No | Return sections observed as changed on or after this date. |
| `document_type` | string ("final" | "proposed" | "presidential") | No | Federal Register document stage: final, proposed, or presidential. |
| `excerpt_chars` | integer | No | Maximum excerpt length per result (100-4000 characters). |
| `published_from` | string | No | Earliest Federal Register publication date to include. |
| `exclude_repealed` | boolean | No | Exclude sections known to be repealed or otherwise inoperative. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Test Board Watch

**Slug:** `VAQUILL_TEST_BOARD_WATCH`

Send one synthetic delivery through a board watch's configured channel immediately. This external side effect is limited to one test per watch every 30 seconds, is not saved in delivery history, and does not change the watch's real last-notified state.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `watch_id` | string | Yes | Watch ID to send a synthetic test delivery through. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Board Watch

**Slug:** `VAQUILL_UPDATE_BOARD_WATCH`

Partially update a Vaquill board watch without changing its delivery channel. Omitted fields remain unchanged. Pause/resume and email updates are available on all plans; webhook destination, signing, and outbound-auth updates require Vaquill Business. This endpoint is free.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `scope` | object | No | Replacement hierarchy, exact act_id, named source, or agency scope. Send null explicitly to return the watch to its whole board. |
| `watch_id` | string | Yes | Watch ID returned by a board-watch create or list action. |
| `is_active` | boolean | No | Set false to pause future notifications or true to resume them. |
| `webhook_url` | string | No | Replacement webhook URL for a webhook or both-channel watch. Cannot be cleared and requires a Vaquill Business plan. |
| `webhook_auth` | object | No | Complete outbound webhook authentication update. Use scheme none to remove it; webhook delivery requires a Vaquill Business plan. |
| `email_address` | string | No | Replacement recipient for an email or both-channel watch. Cannot be cleared. |
| `webhook_secret` | string | No | Replacement webhook signing secret for a webhook or both-channel watch. Use an empty string to stop signing; this Business-only field is never returned. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |