The Vaquill connector lets your AI agent act in each user's Vaquill account. Each user connects their own Vaquill access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 28 tools.
- Tools
- 28
- What they doRead · write · destructive
- 28 · 0 · 028 read0 write0 destructive
- Users sign in with
- Access token
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Vaquill connection
In AgentKit > Connections, create a Vaquill connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'vaquill'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize Vaquill:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'vaquill_count_sections',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "vaquill"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Vaquill:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="vaquill_count_sections",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their Vaquill credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolvaquill_browse_divisionsWalk the statutory tree one level at a time in statutory order: titles, chapters, parts, state codes, constitution articles or federal rule sets, down to the sections.Read-onlyBrowse Divisions
Walk the statutory tree one level at a time in statutory order: titles, chapters, parts, state codes, constitution articles or federal rule sets, down to the sections. Returns the children of the level you name, each with identifier, kind, label, sectionCount and isLeaf; leaf rows are sections with an actId. nextCursor continues long section lists. Costs 1 credit; empty levels are refunded. Use vaquill_browse_divisions to enumerate a code or find a state code identifier for search. Use vaquill_search_statutes to rank by relevance and vaquill_count_sections to size a scope first.
Inputs
corpus_typestringrequired- Corpus to browse: USC, CFR, STATE, REGULATION, CONSTITUTION, STATE_CONSTITUTION or FEDERAL_RULES. With nothing else set it returns the top level (titles, a state's codes, the articles, the rule sets).one of
USCCFRSTATEREGULATIONCONSTITUTIONSTATE_CONSTITUTIONFEDERAL_RULES act_statusstring- List only sections with this status, for example repealed.one of
abolisheddeletedexpiredin_forceinactivenon_precedentialnot_fundednot_yet_effectiveomittedproposedrecodifiedrecompiledrejectedrelocatedremovedrenumberedrepealedrescindedreservedrevokedsupersededterminatedtransferredunconstitutionalvacantvacatedvetoedwithdrawn articlestring- Article to drill into: a constitution's article or amendment (Article III, Amendment XIV) or a New York code article, exactly as the listing returned it.
chapterstring- Chapter to drill into (USC and state codes), for example 21.
codestring- Code to drill into: a state code such as tx_pe (list them with corpus_type STATE and state) or a federal rule set such as frcp (list them with corpus_type FEDERAL_RULES).
cursorstring- nextCursor from the previous response, to continue a long list of sections. Omit for the first page.
exclude_repealedboolean- true leaves out sections whose status is affirmatively dead. Sections with no recorded status are kept. Default false.
partstring- CFR part to drill into, for example 240.
statestring- Two-letter state code, required for STATE, REGULATION and STATE_CONSTITUTION.one of
alakasazarcacoctdedcflgaguhiidiliniakskylamemdmamimnmsmomtnenvnhnjnmnyncndmpohokorpaprriscsdtntxutvtvivawawvwiwy title_numberinteger- USC or CFR title to drill into, for example 42.
vaquill_compare_section_across_statesFind the provisions in other states that address the same subject as a given state statute section.Read-onlyCompare Section Across States
Find the provisions in other states that address the same subject as a given state statute section. Returns neighbors, at most one provision per state ranked by similarity (a 0 to 1 retrieval score, not a legal opinion), with actId, citation and title, plus statesCovered. Federal sections, regulations and court rules return a note and are refunded. Costs 6 credits. Use vaquill_compare_section_across_states for a multi-state comparison starting from one section. Use vaquill_search_statutes with several states when you have no starting section.
Inputs
act_idstringrequired- The section's actId, taken from a search, resolve, browse or batch result, for example USC_T42_C21_S1983 (42 U.S.C. § 1983) or CFR_T17_P240_S240_10b5_1. Do not assemble ids from a citation: their chapter and code segments exist only in Vaquill's data. A plain citation such as 42 USC 1983 is also accepted and adds the 2-credit resolve charge; prefer vaquill_resolve_citation to turn a citation into an actId.
limitinteger- States to return, one provision each, 1 to 25. Default 5.
vaquill_count_sectionsCount the sections in a scope: a jurisdiction, corpus, state code, title, chapter, part, article or federal rule set, optionally by status.Read-onlyCount Sections
Count the sections in a scope: a jurisdiction, corpus, state code, title, chapter, part, article or federal rule set, optionally by status. Returns count, isExact and the scope counted. Costs 1 credit; a scope matching nothing is refunded. Use vaquill_count_sections to size a job before browsing or bulk reading. It takes no text query; use vaquill_search_statutes to rank matches.
Inputs
act_statusarray- Only sections carrying one of these publisher statuses, for example ["repealed"] to audit dead law or ["in_force"] for sections affirmatively marked current. Combining a dead status with exclude_repealed true is rejected with 422.
articlearray- One or more articles: a constitution's article or amendment label as vaquill_browse_divisions lists it (Amendment XIV, Article IV), or the article of a state code divided by articles (New York, for example 2-A). Needs corpus_type from the constitution or STATE/REGULATION families; STATE_CONSTITUTION also needs state.
chapterarray- One or more chapters within a title or state code, for example ["21"] for 42 U.S.C. Chapter 21. Chapter numbers repeat, so pair with title_number (USC) or code (state); an unpaired chapter is rejected.
codearray- Restrict to specific state codes by the identifier vaquill_browse_divisions returns for corpus_type STATE, for example tx_pe (Texas Penal Code) or ca_pen. With corpus_type FEDERAL_RULES a value can instead be a rule set such as frcp or fre. This is the only way to scope below a whole state.
corpus_typearray- Restrict to one or more corpora. USC is the US Code; CFR the Code of Federal Regulations; STATE state statutory codes; CONSTITUTION the US Constitution; STATE_CONSTITUTION state constitutions; FEDERAL_RULES the Federal Rules (FRCP, FRCrP, FRE, FRAP, FRBP); FEDERAL_LOCAL_RULES federal courts' own local rules; STATE_RULES state court rules; REGULATION state administrative regulations; EXECUTIVE_ACTION presidential documents; FEDERAL_REGISTER agency rules (final and proposed); AGENCY_GUIDANCE federal sub-regulatory guidance; STATE_AGENCY_GUIDANCE state insurance bulletins; STATE_AG_OPINION state attorney general opinions; SESSION_LAW, STATUTE_COMPILATION, SENTENCING_GUIDELINES, US_TAX_TREATY, AGENCY_ADJUDICATION and the point-in-time CFR_ANNUAL / USC_ANNUAL editions are also accepted. Pair state-scoped corpora with state. Omit for every corpus. Example: ["USC", "CFR"].
exclude_repealedboolean- true drops sections whose own status says they are no longer operative (repealed, renumbered, superseded, expired and similar). A section with no trustworthy status is kept, so the remainder is not guaranteed good law: read each result's goodLawStatus. Default false.
partarray- One or more CFR parts, for example ["240"] for 17 C.F.R. Part 240. Pair with title_number.
statearray- One or more jurisdictions as lowercase two-letter codes (the 50 states, dc, pr, gu, vi, as, mp), or federal for the US Code, CFR, Constitution and federal rules. An unknown value is rejected with 422. Omit to cover every jurisdiction. Example: ["ca", "ny"].
title_numberinteger- USC or CFR title number, for example 42 (public health and welfare) or 17 (SEC regulations). Only meaningful with USC or CFR.
vaquill_extract_citationsFind every distinct statute, regulation, court rule, constitution and register citation in a block of text and resolve each to the section it names.Read-onlyExtract Citations
Find every distinct statute, regulation, court rule, constitution and register citation in a block of text and resolve each to the section it names. Returns one row per distinct citation with mentions, the resolved actId and section, or a missReason with candidates, plus counts, truncated (more than 200 citations found) and creditsConsumed (2 credits per distinct citation resolved; extraction alone is free). Case citations are not extracted. Long documents with many citations can be slow. Use vaquill_extract_citations to verify the citations in a brief, memo or model answer. Use vaquill_resolve_citations when you already have the citation strings.
Inputs
textstringrequired- The text to read: a brief, memo, email or model answer, 1 to 200,000 characters. Longer text is rejected with 422, never truncated. The text is not stored.
include_unresolvedboolean- false drops citations that did not resolve from the list; counts and charges are unchanged. Default true.
resolveboolean- true (default) resolves each distinct citation at 2 credits each; false returns the extracted citations only, free of charge.
statestring- The document's own jurisdiction as a two-letter code, used for citations that name no state (Civil Rule 56.1, Gov. Code § 12940). Citations that name a state are always checked against that state.one of
alakasazarcacoctdedcflgaguhiidiliniakskylamemdmamimnmsmomtnenvnhnjnmnyncndmpohokorpaprriscsdtntxutvtvivawawvwiwy
vaquill_get_coverageGet the coverage matrix: which corpora Vaquill holds for each jurisdiction and how many documents each has, with a legend of every corpusType and whether it can be browsed.Read-onlyGet Coverage
Get the coverage matrix: which corpora Vaquill holds for each jurisdiction and how many documents each has, with a legend of every corpusType and whether it can be browsed. Returns data with per-jurisdiction corpora counts, state session-law coverage, and meta with totals and measuredAt. Free, but the unfiltered matrix is about 1 MB, so pass state. Use vaquill_get_coverage before searching to learn what is queryable where. Use vaquill_list_boards for how recently each source was refreshed.
Inputs
statestring- Return only this jurisdiction (two-letter code or federal). Strongly recommended: the unfiltered matrix is about a megabyte and can be slow.one of
federalalakasazarcacoctdedcflgaguhiidiliniakskylamemdmamimnmsmomtnenvnhnjnmnyncndmpohokorpaprriscsdtntxutvtvivawawvwiwy
vaquill_get_credit_balanceGet the API credits this key's account can spend right now, and its rate limits.Read-onlyGet Credit Balance
Get the API credits this key's account can spend right now, and its rate limits. Returns creditsRemaining, usdRemaining, bySource (subscription credits expire, pay-as-you-go persist), nextExpiry, plan, totalPurchased, totalConsumed and rateLimit. Free. Use vaquill_get_credit_balance as a pre-flight check before credit-heavy calls. Use vaquill_get_pricing for what each endpoint costs.
Inputs
This tool takes no inputs.
vaquill_get_pricingGet Vaquill's credit pricing: the dollar value of a credit and the credit cost of every metered endpoint.Read-onlyGet Pricing
Get Vaquill's credit pricing: the dollar value of a credit and the credit cost of every metered endpoint. Returns dollarPerCredit, minCredits, maxCredits and costs with endpoint, operation, credits, usdCost and description. Free. Use vaquill_get_pricing to estimate the cost of a research plan. Use vaquill_get_credit_balance for the credits left.
Inputs
regionstring- Jurisdiction to price: US for the US primary-law API, IN for the India legislation API. Default US.one of
USIN
vaquill_get_sectionGet one statute, regulation or rule section's metadata by actId.Read-onlyGet Section
Get one statute, regulation or rule section's metadata by actId. Returns the section's citation, title, title and chapter hierarchy, breadcrumb, status and goodLawStatus, amendment history, and links to every available format (HTML, PDF, XML, text, DOCX) and the official source, but not its text. Costs 2 credits; a 404 is not charged. Use vaquill_get_section for one section's details. Use vaquill_get_section_text for the full text, vaquill_get_sections for up to 50 ids at once, and vaquill_resolve_citation to start from a citation.
Inputs
act_idstringrequired- The section's actId, taken from a search, resolve, browse or batch result, for example USC_T42_C21_S1983 (42 U.S.C. § 1983) or CFR_T17_P240_S240_10b5_1. Do not assemble ids from a citation: their chapter and code segments exist only in Vaquill's data. A plain citation such as 42 USC 1983 is also accepted and adds the 2-credit resolve charge; prefer vaquill_resolve_citation to turn a citation into an actId.
vaquill_get_section_definitionsGet the defined terms that govern a section, parsed from its chapter's definitions section.Read-onlyGet Section Definitions
Get the defined terms that govern a section, parsed from its chapter's definitions section. Returns terms with their definitions, definitionsSection (the section they come from, for citing), total and a note when terms could not be parsed. Strongest on the US Code; CFR and state codes are best effort. Costs 4 credits, refunded when no terms are returned. Use vaquill_get_section_definitions to learn what words like person or employee mean in a statute. Use vaquill_get_section_text to read the definitions section directly.
Inputs
act_idstringrequired- The section's actId, taken from a search, resolve, browse or batch result, for example USC_T42_C21_S1983 (42 U.S.C. § 1983) or CFR_T17_P240_S240_10b5_1. Do not assemble ids from a citation: their chapter and code segments exist only in Vaquill's data. A plain citation such as 42 USC 1983 is also accepted and adds the 2-credit resolve charge; prefer vaquill_resolve_citation to turn a citation into an actId.
vaquill_get_section_textGet the full text of one statute, regulation or rule section by actId, optionally as it stood on a past date.Read-onlyGet Section Text
Get the full text of one statute, regulation or rule section by actId, optionally as it stood on a past date. Returns html and plain text by default (or markdown, the operative text only, or a subsection tree), with tables and figures where published, the official sourceUrl, and available: false with a note when the text is not ingested. Costs 6 credits only when text is returned. Use vaquill_get_section_text to read or quote the law. Use vaquill_get_section for metadata and format links only, and vaquill_get_sections with include_body to read many sections in one call. Requires an actId from vaquill_search_statutes, vaquill_resolve_citation or vaquill_browse_divisions.
Inputs
act_idstringrequired- The section's actId, taken from a search, resolve, browse or batch result, for example USC_T42_C21_S1983 (42 U.S.C. § 1983) or CFR_T17_P240_S240_10b5_1. Do not assemble ids from a citation: their chapter and code segments exist only in Vaquill's data. A plain citation such as 42 USC 1983 is also accepted and adds the 2-credit resolve charge; prefer vaquill_resolve_citation to turn a citation into an actId.
as_ofstring- Return the text as it stood on this date, YYYY-MM-DD, reconstructed from observed changes. Read the asOf block, especially isBounded, before citing the result. Same cost.
formatstring- Which representations to return. both (default) returns html and plain; html or plain alone halves the payload; all adds markdown; markdown returns only markdown (tables as pipe tables); content returns only the operative text without the source credit and notes; operative is the same narrower view. Cost is the same for every format.one of
allbothhtmlmarkdownplaincontentoperative structuredboolean- true also returns a subsections tree parsed from the text, for pinpoint citations, with markdown rendered as nested lists. Same cost. Default false.
vaquill_get_sectionsGet metadata, and optionally full text, for up to 50 sections by actId in one call.Read-onlyGet Sections
Get metadata, and optionally full text, for up to 50 sections by actId in one call. Returns sections in the order requested, notFound and notFoundDetail for misses (with didYouMean suggestions for assembled ids), resolved for citations given in place of ids, and creditsConsumed (2 credits per section returned, plus 6 per body). Use vaquill_get_sections to hydrate many search or browse results at once. Use vaquill_get_section or vaquill_get_section_text for a single section.
Inputs
act_idsarrayrequired- Up to 50 actIds from earlier results, for example ["USC_T42_C21_S1983", "CFR_T17_P240_S240_10b5_1"]. Duplicates are collapsed and order is kept. Citations are also accepted and resolved at 2 extra credits each. Do not assemble ids from citations.
include_bodyboolean- true also returns each section's full text on body, adding 6 credits per row with text. Default false.
vaquill_get_session_lawGet everything Vaquill holds about one state session law except its text, by id or by citation.Read-onlyGet Session Law
Get everything Vaquill holds about one state session law except its text, by id or by citation. Returns sessionLawId, citation and citableAs, session, title, bill number, approvedDate, effectiveDates, enactmentOutcome, the code sections it affects, textStatus, estimatedBodyPages and the official sourceUrl. Costs 2 credits, plus 2 when a citation is given. Use vaquill_get_session_law to identify an act and its dates. Use vaquill_get_session_law_text to read it and vaquill_get_session_laws for up to 50 at once.
Inputs
session_law_idstringrequired- A state session law's id, for example SSL_MN_2025S1_G_Y2025_C1, or a citation or bill number naming the state, for example Minn. Laws 2025, ch. 1 or S.F.No. 1552. A citation adds the 2-credit resolve charge; prefer the id.
jurisdictionstring- Two-letter state code that scopes a citation that names no state (Laws 2025, ch. 1 with mn). Ignored for an id.one of
alakasazarcacoctdedcflgaguhiidiliniakskylamemdmamimnmsmomtnenvnhnjnmnyncndmpohokorpaprriscsdtntxutvtvivawawvwiwy
vaquill_get_session_law_textRead a state session law's text as printed, one page of about 30,000 characters at a time.Read-onlyGet Session Law Text
Read a state session law's text as printed, one page of about 30,000 characters at a time. Returns text, pageStart, pageEnd, totalChars, totalPages, pagePrice, estimatedRemainingCredits, nextCursor and hasMore, with citation and sourceUrl; available false with a reason when the text is not served (not charged). Costs 6 credits per page; check estimatedBodyPages first, as omnibus acts run to hundreds of pages. Use vaquill_get_session_law_text to read an act. Use vaquill_get_session_law for its record and dates. Requires a sessionLawId from vaquill_list_session_laws, vaquill_search_session_laws or vaquill_get_session_law.
Inputs
session_law_idstringrequired- A state session law's id from a list, search or changes result, for example SSL_MN_2025S1_G_Y2025_C1.
cursorstring- nextCursor from the previous page. Omit for the first page. Send cursor or start_char, never both.
expect_text_sha256string- The textSha256 you read the text under (16 to 64 lowercase hex characters). If the text was re-collected since, the call returns 409 and is not charged. Use with start_char.
start_charinteger- Start the page at this 0-based character offset into the text instead of using a cursor. Send cursor or start_char, never both.
vaquill_get_session_lawsGet the full records of up to 50 state session laws in one call, by id or citation, optionally with the first page of each law's text.Read-onlyGet Session Laws
Get the full records of up to 50 state session laws in one call, by id or citation, optionally with the first page of each law's text. Returns laws (each carrying the input it answers), resolved for inputs that matched a different spelling, notFound with a status and candidates for every miss, deduped and creditsConsumed (2 credits per law served, plus 6 per body page). Use vaquill_get_session_laws to read many acts from a list or changes feed. Use vaquill_get_session_law for one act.
Inputs
idsarrayrequired- Up to 50 distinct session law ids or citations, for example ["SSL_MN_2025R_G_Y2025_C1", "S.F.No. 1552"]. Duplicates are collapsed first. Citations add the 2-credit resolve charge each.
include_bodyboolean- true also returns the first page (about 30,000 characters) of each law's text, at 6 credits per law with text. Default false.
jurisdictionstring- Two-letter state code supplying the state for citations that name none, for the whole batch. Ignored for ids.one of
alakasazarcacoctdedcflgaguhiidiliniakskylamemdmamimnmsmomtnenvnhnjnmnyncndmpohokorpaprriscsdtntxutvtvivawawvwiwy
vaquill_get_watch_change_diffGet a section's text before and after one change on a watched source.Read-onlyGet Watch Change Diff
Get a section's text before and after one change on a watched source. Returns before and after text with hasBefore and hasAfter (amended changes have both, added only after, removed only before) and creditsConsumed. Costs 4 credits; diffs missing a side of an amendment are refunded. Use vaquill_get_watch_change_diff to see exactly what changed. Use vaquill_list_watch_changes to find changes with hasDiff true. Requires a watch id from vaquill_list_watches and a change id from vaquill_list_watch_changes.
Inputs
change_idintegerrequired- The change id from vaquill_list_watch_changes.
watch_idstringrequired- The watch id from vaquill_list_watches.
vaquill_list_boardsList the tracked law sources (boards, one per corpus type and state) with how recently and how often each is refreshed.Read-onlyList Boards
List the tracked law sources (boards, one per corpus type and state) with how recently and how often each is refreshed. Returns boards with corpusType, state, lastRetrievedAt, cadence and publishesSourceChangedOn, plus total and hasMore. Free. Use vaquill_list_boards to check how current a source is before trusting a count or a quiet watch. Use vaquill_get_coverage for what each jurisdiction holds.
Inputs
corpus_typestring- Only boards for this corpus type, case-insensitive, for example state_regulation, cfr or federal_register. An unknown value returns an empty page.
limitinteger- Boards to return, 1 to 500. Default 500.
offsetinteger- Boards to skip for paging. Default 0.
statestring- Only boards for this jurisdiction; federal selects boards with no state (USC, eCFR, Federal Register).one of
federalalakasazarcacoctdedcflgaguhiidiliniakskylamemdmamimnmsmomtnenvnhnjnmnyncndmpohokorpaprriscsdtntxutvtvivawawvwiwy
vaquill_list_citing_sectionsList the US Code and CFR sections whose text cross-references a given section.Read-onlyList Citing Sections
List the US Code and CFR sections whose text cross-references a given section. Returns citers in statutory order with actId, citation and title, total, truncated, and a note when the section's corpus has no cross-reference index (state codes and Federal Register rules, refunded). Costs 2 credits. Use vaquill_list_citing_sections to find what depends on a section before it changes. Use vaquill_get_section to see what the section itself cites.
Inputs
act_idstringrequired- The section's actId, taken from a search, resolve, browse or batch result, for example USC_T42_C21_S1983 (42 U.S.C. § 1983) or CFR_T17_P240_S240_10b5_1. Do not assemble ids from a citation: their chapter and code segments exist only in Vaquill's data. A plain citation such as 42 USC 1983 is also accepted and adds the 2-credit resolve charge; prefer vaquill_resolve_citation to turn a citation into an actId.
limitinteger- Citing sections to return, 1 to 100. Default 25.
vaquill_list_neighboring_sectionsList the sections immediately before and after a section in statutory order, within its chapter or code.Read-onlyList Neighboring Sections
List the sections immediately before and after a section in statutory order, within its chapter or code. Returns the section, previous and next lists with actId, citation and title, and the container. Costs 2 credits. Use vaquill_list_neighboring_sections to find nearby definitions and exceptions. Use vaquill_browse_divisions to list a whole chapter and vaquill_get_section_definitions for defined terms.
Inputs
act_idstringrequired- The section's actId, taken from a search, resolve, browse or batch result, for example USC_T42_C21_S1983 (42 U.S.C. § 1983) or CFR_T17_P240_S240_10b5_1. Do not assemble ids from a citation: their chapter and code segments exist only in Vaquill's data. A plain citation such as 42 USC 1983 is also accepted and adds the 2-credit resolve charge; prefer vaquill_resolve_citation to turn a citation into an actId.
limitinteger- Sections to return on each side, 1 to 10. Default 3.
vaquill_list_section_changesList the changes Vaquill's refreshes have observed to one section: when it was added, each time its text was replaced, and whether it was removed.Read-onlyList Section Changes
List the changes Vaquill's refreshes have observed to one section: when it was added, each time its text was replaced, and whether it was removed. Returns the section (null when removed), changes with id, changeKind and detectedAt (when Vaquill saw it, not the effective date), hasMore, cursor and a coverage note. Costs 1 credit. An empty list means no captured change, not never amended. Use vaquill_list_section_changes to check whether a section moved since you last reviewed it. Use vaquill_get_section for the publisher's own amendment history and vaquill_list_section_enactments for the session laws that amended it.
Inputs
act_idstringrequired- The section's actId, taken from a search, resolve, browse or batch result, for example USC_T42_C21_S1983 (42 U.S.C. § 1983) or CFR_T17_P240_S240_10b5_1. Do not assemble ids from a citation: their chapter and code segments exist only in Vaquill's data. A plain citation such as 42 USC 1983 is also accepted and adds the 2-credit resolve charge; prefer vaquill_resolve_citation to turn a citation into an actId.
before_idinteger- Only changes with an id less than this, to walk back through history; pass the smallest id on your last page.
change_kindarray- Only these kinds: added, amended, removed. Omit for all three.
limitinteger- Changes per page, 1 to 200. Default 50.
orderstring- desc (default) is newest first; asc replays forward, best when catching up from a cursor.one of
ascdesc since_idinteger- Only changes with an id greater than this; pass cursor from your last page to poll forward.
vaquill_list_section_enactmentsList the state session laws that a publisher's own tables say added, amended or repealed one code section.Read-onlyList Section Enactments
List the state session laws that a publisher's own tables say added, amended or repealed one code section. Returns supported, enactments with sessionLawId, href, action (added, amended, repealed, renumbered, other), effective dates and the publisher's printed values, and a coverage note. Only CA, DC, HI, KY, MO, MS, NE, UT and WA are supported; other sections return supported false and are not charged. Costs 1 credit. Use vaquill_list_section_enactments to trace which act changed a state section. Use vaquill_get_session_law to read the act and vaquill_list_section_changes for observed text changes.
Inputs
act_idstringrequired- The section's actId, taken from a search, resolve, browse or batch result, for example USC_T42_C21_S1983 (42 U.S.C. § 1983) or CFR_T17_P240_S240_10b5_1. Do not assemble ids from a citation: their chapter and code segments exist only in Vaquill's data. A plain citation such as 42 USC 1983 is also accepted and adds the 2-credit resolve charge; prefer vaquill_resolve_citation to turn a citation into an actId.
vaquill_list_session_law_changesRead the change feed of the state session-law registry: laws that began to be served, gained text, were corrected, unserved, withdrawn or merged, oldest first.Read-onlyList Session Law Changes
Read the change feed of the state session-law registry: laws that began to be served, gained text, were corrected, unserved, withdrawn or merged, oldest first. Returns changes with id, kind, sessionLawId, jurisdiction and detectedAt, plus cursor and hasMore. Costs 1 credit per page, including empty pages. Use vaquill_list_session_law_changes to keep a copy of the registry in sync. Use vaquill_list_session_laws with updated_since for a date-based pull.
Inputs
jurisdictionstring- Limit the feed to one state, dc or pr.one of
alakasazarcacoctdedcflgaguhiidiliniakskylamemdmamimnmsmomtnenvnhnjnmnyncndmpohokorpaprriscsdtntxutvtvivawawvwiwy limitinteger- Entries per page, 1 to 200. Default 50. The price is per page.
since_idinteger- Return only entries with an id greater than this. Send 0 (the default) to start, then the cursor from your last page.
vaquill_list_session_lawsList one state's session laws (acts as enacted), filtered by session, approval or effective dates, series, measure type, enactment outcome, text status, update date or title text.Read-onlyList Session Laws
List one state's session laws (acts as enacted), filtered by session, approval or effective dates, series, measure type, enactment outcome, text status, update date or title text. Returns results with sessionLawId, citation, title, approvedDate, effectiveFirst and effectiveLast, enactmentOutcome and textStatus, plus nextCursor and hasMore; an empty page carries coverage saying whether the session is complete. Costs 1 credit per page; empty pages on partly collected sessions are free. Use vaquill_list_session_laws to answer what became law, or takes effect, in a state and when. Use vaquill_search_session_laws to search by content.
Inputs
jurisdictionstringrequired- Two-letter code of the state whose session laws to list: the 50 states, dc or pr. Case-insensitive.one of
alakasazarcacoctdedcflgaguhiidiliniakskylamemdmamimnmsmomtnenvnhnjnmnyncndmpohokorpaprriscsdtntxutvtvivawawvwiwy approved_fromstring- Only laws signed on or after this date, YYYY-MM-DD.
approved_tostring- Only laws signed on or before this date, YYYY-MM-DD.
cursorstring- nextCursor from the previous page, sent with the same filters. Omit for the first page.
effective_fromstring- Only laws whose effective-date span overlaps a window starting on this date, YYYY-MM-DD. For one day, send the same date to effective_to. Laws with no printed effective date never match.
effective_tostring- End of the effective-date window, YYYY-MM-DD.
enactment_outcomearray- Only laws with one of these outcomes, for example ["vetoed", "pocket_veto"].
has_textboolean- true lists only laws whose text is served; false only laws whose text is not served.
instrument_typearray- Kinds of measure to include (OR): act (an ordinary law), joint_resolution, concurrent_resolution, resolution, resolve, memorial, other.
is_lawboolean- true lists measures that are law; false lists numbered measures that are not (vetoed, pocket veto).
limitinteger- Rows per page, 1 to 200. Default 50. The price is per page.
qstring- Only laws whose title or printed bill number contains this text (3 to 100 characters, case-insensitive substring, no ranking).
seriesarray- Numbering series to include (OR), as a result's series reports it, for example ["general"] (the ordinary chapter sequence) or ["resolve", "resolves"].
sessionstring- Only laws from this session, by its code: 2025R is the 2025 regular session, 2025S1 the first 2025 special session. Case-sensitive.
text_statusstring- Only laws with this text status: held (served), withheld, not_held or pending.one of
heldwithheldnot_heldpending updated_sincestring- Only laws whose record changed on or after this date, YYYY-MM-DD, for sync jobs.
vaquill_list_watch_changesList the sections a watched source added, amended or removed, newest first, across the source's whole captured history.Read-onlyList Watch Changes
List the sections a watched source added, amended or removed, newest first, across the source's whole captured history. Returns changes with id, changeKind, actId, citation, title, detectedAt and hasDiff, and meta with cursor and hasMore. Free. Use vaquill_list_watch_changes to see which sections changed in a watched source. Use vaquill_get_watch_change_diff for the before and after text of one change, and vaquill_list_section_changes for a single section without a watch. Requires a watch id from vaquill_list_watches.
Inputs
watch_idstringrequired- The watch id from vaquill_list_watches.
before_idinteger- Only changes with an id less than this, to walk back through history; pass the smallest id on your last page.
change_kindarray- Only these kinds: added, amended, removed. Omit for all three.
limitinteger- Changes per page, 1 to 200. Default 50.
orderstring- desc (default) is newest first; asc replays forward, best when catching up from a cursor.one of
ascdesc sincestring- Only changes detected strictly after this ISO 8601 timestamp. Coarser than since_id.
since_idinteger- Only changes with an id greater than this; carry meta.cursor forward from your last page.
vaquill_list_watchesList the law-change watches (board subscriptions) owned by this API key's account.Read-onlyList Watches
List the law-change watches (board subscriptions) owned by this API key's account. Returns watches with id, board corpusType and state, channel, scope, isActive, lastNotifiedAt and lastStatus. Free. Use vaquill_list_watches to find a watch id for vaquill_list_watch_changes. Watches are created and managed in Vaquill, not through this connector.
Inputs
limitinteger- Watches to return, 1 to 200. Default 100.
offsetinteger- Watches to skip for paging. Default 0.
vaquill_resolve_citationResolve one Bluebook-style statute, regulation, rule or constitution citation to the exact section it names, to verify a citation or find its actId.Read-onlyResolve Citation
Resolve one Bluebook-style statute, regulation, rule or constitution citation to the exact section it names, to verify a citation or find its actId. Returns resolved true with the section's full metadata and official source link, or resolved false with a missReason (ambiguous_jurisdiction, out_of_scope_corpus, former_law, malformed, not_held), candidates and a hint; matchLevel flags container, multiple or repaired matches, and a state session law citation comes back in sessionLaw. Costs 2 credits whether or not it resolves. Use vaquill_resolve_citation for a single citation. Use vaquill_resolve_citations for up to 50 at once and vaquill_extract_citations to find and check every citation in a block of text. Case citations are not supported.
Inputs
citestringrequired- A citation string to resolve, 2 to 200 characters, for example 42 U.S.C. 1983, 16 C.F.R. 444.1, Cal. Civ. Code 1950.5 or Del. Code Ann. tit. 13, 1301. A pinpoint such as 42 U.S.C. 1983(b)(2) resolves to the parent section and is echoed in subsection.
corpus_typestring- Corpus to resolve within: STATE (statutory text, federal or state), REGULATION, STATE_RULES, CONSTITUTION or STATE_CONSTITUTION. A citation from another corpus resolves to nothing.one of
CONSTITUTIONREGULATIONSTATESTATE_CONSTITUTIONSTATE_RULES statestring- Jurisdiction to resolve within, as a two-letter code or federal. A constraint, not a hint: a citation naming another jurisdiction returns resolved false. Useful for shared forms such as 22 CCR (California) versus 8 CCR (Colorado).one of
federalalakasazarcacoctdedcflgaguhiidiliniakskylamemdmamimnmsmomtnenvnhnjnmnyncndmpohokorpaprriscsdtntxutvtvivawawvwiwy
vaquill_resolve_citationsResolve up to 50 statute, regulation, rule or constitution citations to their exact sections in one call.Read-onlyResolve Citations
Resolve up to 50 statute, regulation, rule or constitution citations to their exact sections in one call. Returns one result per unique citation in input order, each with resolved, the matched section's metadata or a missReason with candidates, plus resolvedCount and creditsConsumed (2 credits per citation, resolved or not). Use vaquill_resolve_citations to check a list of citations you already hold. Use vaquill_resolve_citation for one, and vaquill_extract_citations when the citations are still embedded in text.
Inputs
citationsarrayrequired- Citation strings to resolve, up to 50 unique per call (duplicates are collapsed first, order kept). Example: ["42 U.S.C. 1983", "16 C.F.R. 444.1", "Cal. Civ. Code 1950.5"].
corpus_typestring- Corpus to resolve every citation within: STATE, REGULATION, STATE_RULES, CONSTITUTION or STATE_CONSTITUTION.one of
CONSTITUTIONREGULATIONSTATESTATE_CONSTITUTIONSTATE_RULES statestring- Jurisdiction to resolve every citation within, as a two-letter code or federal. Omit for a batch spanning jurisdictions.one of
federalalakasazarcacoctdedcflgaguhiidiliniakskylamemdmamimnmsmomtnenvnhnjnmnyncndmpohokorpaprriscsdtntxutvtvivawawvwiwy
vaquill_search_session_lawsSearch the enacted text of 2025 state session laws (acts as passed, before codification) by keywords, a quoted phrase, a code section or a bill number.Read-onlySearch Session Laws
Search the enacted text of 2025 state session laws (acts as passed, before codification) by keywords, a quoted phrase, a code section or a bill number. Returns laws best first, each with sessionLawId, citation, title, approval date, matchType, matchedBy and a snippet of the matching passage, plus hasMore. Costs 4 credits per page. Use vaquill_search_session_laws to find acts by what they say. Use vaquill_list_session_laws to filter one state's acts by session or date, and vaquill_search_statutes for the codified law.
Inputs
querystringrequired- What to look for, 2 to 300 characters: a plain question, words from a title, a quoted phrase ("credit card or debit card"), a code section (63-3004) or a bill number (S.F.No. 1552). Ranking is keyword based (stemmed), not semantic, so use the legislature's vocabulary.
approved_fromstring- Only laws approved on or after this date, YYYY-MM-DD.
approved_tostring- Only laws approved on or before this date, YYYY-MM-DD.
instrument_typearray- Kinds of measure to include (OR): act (an ordinary law), joint_resolution, concurrent_resolution, resolution, resolve, memorial, other.
jurisdictionstring- Limit to one state, dc or pr (two-letter code). Omit to search every jurisdiction held.one of
alakasazarcacoctdedcflgaguhiidiliniakskylamemdmamimnmsmomtnenvnhnjnmnyncndmpohokorpaprriscsdtntxutvtvivawawvwiwy limitinteger- Laws per page, 1 to 25. Default 10.
offsetinteger- Laws to skip, 0 to 59; offset plus limit reaches at most the 60 best matches. Each page is a new, charged search. Default 0.
seriesarray- Numbering series to include (OR), as a result's series reports it, for example ["general"] (the ordinary chapter sequence) or ["resolve", "resolves"].
sessionstring- Limit to one session by its code, for example 2025R (regular) or 2025S1 (first special). Case-sensitive.
vaquill_search_statutesSearch US federal and state primary law (statutes, regulations, constitutions, court rules, executive orders, Federal Register rules and agency guidance) by natural-language question, keywords, exact phrase or citation, filtered by corpus, jurisdiction, code, title, chapter, part, status and dates.Read-onlySearch US Law
Search US federal and state primary law (statutes, regulations, constitutions, court rules, executive orders, Federal Register rules and agency guidance) by natural-language question, keywords, exact phrase or citation, filtered by corpus, jurisdiction, code, title, chapter, part, status and dates. Returns a ranked page of sections, each with actId, citation, title, hierarchy, an excerpt, actStatus, goodLawStatus and an official sourceUrl, plus hasMore for paging and creditsConsumed (4 credits per call, plus 6 per row when include_body is true). Use vaquill_search_statutes to find the law on a topic. Use vaquill_resolve_citation when you already hold a citation, vaquill_browse_divisions to walk a code in statutory order, and vaquill_search_session_laws for 2025 state session laws as enacted. Case law is not covered.
Inputs
querystringrequired- What to look for, 2 to 500 characters: a natural-language question (insider trading penalties), keywords, an exact phrase with match_type phrase, or a citation such as 42 U.S.C. § 1983 to pull up one section.
act_statusarray- Only sections carrying one of these publisher statuses, for example ["repealed"] to audit dead law or ["in_force"] for sections affirmatively marked current. Combining a dead status with exclude_repealed true is rejected with 422.
agencyarray- Federal Register agency slugs, names or acronyms, for example ["environmental-protection-agency"] or ["EPA"]. Applies to FEDERAL_REGISTER and EXECUTIVE_ACTION only. An ambiguous acronym is rejected with 422.
articlearray- One or more articles: a constitution's article or amendment label as vaquill_browse_divisions lists it (Amendment XIV, Article IV), or the article of a state code divided by articles (New York, for example 2-A). Needs corpus_type from the constitution or STATE/REGULATION families; STATE_CONSTITUTION also needs state.
changed_sincestring- Only sections Vaquill observed changing on or after this date, YYYY-MM-DD. These are detected changes, not effective dates, and capture coverage varies by source.
chapterarray- One or more chapters within a title or state code, for example ["21"] for 42 U.S.C. Chapter 21. Chapter numbers repeat, so pair with title_number (USC) or code (state); an unpaired chapter is rejected.
codearray- Restrict to specific state codes by the identifier vaquill_browse_divisions returns for corpus_type STATE, for example tx_pe (Texas Penal Code) or ca_pen. With corpus_type FEDERAL_RULES a value can instead be a rule set such as frcp or fre. This is the only way to scope below a whole state.
corpus_typearray- Restrict to one or more corpora. USC is the US Code; CFR the Code of Federal Regulations; STATE state statutory codes; CONSTITUTION the US Constitution; STATE_CONSTITUTION state constitutions; FEDERAL_RULES the Federal Rules (FRCP, FRCrP, FRE, FRAP, FRBP); FEDERAL_LOCAL_RULES federal courts' own local rules; STATE_RULES state court rules; REGULATION state administrative regulations; EXECUTIVE_ACTION presidential documents; FEDERAL_REGISTER agency rules (final and proposed); AGENCY_GUIDANCE federal sub-regulatory guidance; STATE_AGENCY_GUIDANCE state insurance bulletins; STATE_AG_OPINION state attorney general opinions; SESSION_LAW, STATUTE_COMPILATION, SENTENCING_GUIDELINES, US_TAX_TREATY, AGENCY_ADJUDICATION and the point-in-time CFR_ANNUAL / USC_ANNUAL editions are also accepted. Pair state-scoped corpora with state. Omit for every corpus. Example: ["USC", "CFR"].
document_typestring- Federal Register document stage: final (a rule in force), proposed (a proposed rule) or presidential (a presidential document).one of
finalproposedpresidential excerpt_charsinteger- Characters of matching text in each result's excerpt, 100 to 4000. Default 500.
exclude_repealedboolean- true drops sections whose own status says they are no longer operative (repealed, renumbered, superseded, expired and similar). A section with no trustworthy status is kept, so the remainder is not guaranteed good law: read each result's goodLawStatus. Default false.
fieldsarray- Return only these result fields to shrink the response, for example ["title", "excerpt", "sourceUrl"]. actId and citation are always included. Unknown names are rejected with 422. Omit for the full object (40+ fields, mostly null).
include_bodyboolean- true returns each hit's full text inline on body, adding 6 credits per row that returns text (10 rows is 4 + 60 credits). Large pages with bodies can be slow and large; keep limit small. Default false.
limitinteger- Results per page, 1 to 50. Default 10.
match_typestring- any (default) is hybrid semantic plus keyword ranking for natural-language questions; all requires every query word; phrase requires the exact phrase, contiguous and in order. Whole words, case-insensitive.one of
anyallphrase offsetinteger- Results to skip for paging, 0 to 70; the deepest reachable result is offset plus limit. Check hasMore before asking for the next page. Default 0.
partarray- One or more CFR parts, for example ["240"] for 17 C.F.R. Part 240. Pair with title_number.
published_fromstring- Only Federal Register documents published on or after this date, YYYY-MM-DD.
published_tostring- Only Federal Register documents published on or before this date, YYYY-MM-DD.
sourcearray- Named sources inside a corpus that bundles several, for example ["frcp"] within FEDERAL_RULES, ["far"] within CFR, or an agency guidance source such as irs_rev_rul, fincen_guidance or hhs_ocr_hipaa_guidance within AGENCY_GUIDANCE.
statearray- One or more jurisdictions as lowercase two-letter codes (the 50 states, dc, pr, gu, vi, as, mp), or federal for the US Code, CFR, Constitution and federal rules. An unknown value is rejected with 422. Omit to cover every jurisdiction. Example: ["ca", "ny"].
title_numberinteger- USC or CFR title number, for example 42 (public health and welfare) or 17 (SEC regulations). Only meaningful with USC or CFR.
year_frominteger- Only sections dated in or after this year (last credited amendment, else effective year, else publication year). Sections with none of those dates are excluded once a bound is set. Example: 2020.
year_tointeger- Only sections dated in or before this year, on the same dates as year_from. A section amended after this year is excluded even if it existed then; this is a currency filter, not point-in-time retrieval.
No tools match.
