{
"results": [
{
"sessionLawId": "SSL_MN_2025R_G_Y2025_C10",
"jurisdiction": "mn",
"citation": "CHAPTER 10--H.F.No. 2184",
"citableAs": "Minn. Laws 2025, ch. 10",
"citationShort": "MN ch. 10 (2025)",
"session": {
"code": "2025R",
"label": "2025 Regular Session",
"type": "regular",
"year": 2025
},
"series": "general",
"instrumentType": "act",
"number": "10",
"billNumber": "H.F.No. 2184",
"numberingYear": 2025,
"title": "An act relating to court fees; exempting the Office of Ombudsperson for American Indian Families from court fee requirements; amending Minnesota Statutes 2024, section 357.021, subdivision 1a.",
"approvedDate": "2025-04-30",
"approvedDateDerived": false,
"enactmentOutcome": "signed",
"isLaw": true,
"textStatus": "held",
"charCount": 4561,
"estimatedBodyPages": 1,
"textSha256": "6c4008d050a5b85a7eaf03cd6f26ccca5160f015bbeb7bf9dceece9bd8bcd8d9",
"versionNo": 1,
"amendatoryMarkup": "preserved",
"markupConvention": "publisher_literal",
"documentKind": "session_law_print",
"identityConfidence": "single_source",
"licenseNote": "Government public: published by a government body with no restrictive terms, so the text may be reused, including commercially.",
"updatedAt": "2026-10-05T09:06:39.998043+00:00"
}
],
"count": 1,
"hasMore": false,
"processingTimeMs": 204.1,
"creditsConsumed": 1
}
List a state's session laws
List the session laws of one state: every act its legislature enacted, filtered
by session, approval date or effective date. This is how you ask “what became law
in Texas this session”, “what was signed in April” or “what takes effect on
September 1, 2025”, and how you turn the answer into sessionLawIds for the get
and body endpoints. A session law is the act as enacted, before it is folded into
a code; v1 serves STATE acts.
Cost: 1 credit per page of up to 200 rows (default
50), however many rows the page holds. An empty page is an answer and is
charged when it means nothing matches your filters. A request that fails validation (422)
is never charged; a failure on our side (500, 503) is refunded.
Empty pages. A page with no rows carries coverage, what we hold of the session you
named (or of the state, when you named none), so you can tell “nothing matches” from “we
have not collected this”. coverage.status is complete (we hold every law the publisher
lists for it: the empty page is a true negative, and it is charged), partial (the
collection stopped short, so the law you want may exist) or not_held (we hold nothing of
it). On partial and not_held the page is NOT charged and creditsConsumed is 0: we
do not bill an empty answer that may be our gap. The one exception is a request that
names only the state, where some sessions we hold are complete and some partial: the page
is charged, since for the complete ones it is a true negative, and coverage.partialSessions
names the sessions to doubt (send one as session to ask about it alone). If coverage
cannot be read the page is charged as before and coverage is omitted.
Filters.jurisdiction is required and scopes everything; the rest narrow it
and combine with AND. A value that is malformed is a 422, and so is a range whose end is before its
start (approvedTo before approvedFrom, effectiveTo before effectiveFrom). A value that is well
formed and matches nothing (an unknown session, a date range with no laws) is a
200 with results: []. Dates are YYYY-MM-DD.
Everything from one session: session (2025R, 2025S1).
Approved in a window: approvedFrom / approvedTo.
Taking effect in a window: effectiveFrom / effectiveTo. For one day send the
same date to both. This matches laws whose first-to-last effective dates overlap
your window, so read effectiveFirst and effectiveLast on each row and
effectiveDates on the law. A law with no held effective date (not every state
prints them) never matches.
Narrow by series, instrumentType, hasText or textStatus.
What became law and what did not: isLaw (false for the vetoed and pocket-vetoed
measures; a measure whose outcome does not settle it has a null isLaw and matches
neither value) and enactmentOutcome, repeated for several outcomes
(enactmentOutcome=vetoed&enactmentOutcome=pocket_veto).
A sync job: updatedSince returns the laws whose record changed on or after a date
(midnight UTC, by updatedAt), so a job that stores its last run pulls only what is new
or corrected.
Find by words: q, a case-insensitive substring of the title or the bill number as
the publisher prints it (3 to 100 characters). It is a substring match inside one
state, not a search engine.
A derived approval date (approvedDateDerived: true) is not matched by approvedFrom
and approvedTo, which read the registry’s own approval date.
Paging. Rows come in session.code order, then sessionLawId, both as TEXT in the
database’s collation, not in chapter order: ..._C10 sorts before ..._C2, and the id’s
series and numbering-year segments sort before the chapter. Sort client-side by number
if you need chapter order. The order is the same on every page and for every filter,
so a cursor never skips or repeats a row. Send
nextCursor back as cursor, with the same filters, while hasMore is true (a
cursor sent with different filters is a 422, cursor_query_mismatch: restart
without it). The cursor is a keyset (it names the last row you saw), so laws added between your
calls never repeat or skip a row you have passed. count is the size of this
page, never a total.
Text. Rows include laws whose text we do not hold (textStatus: not_held) or
hold and withhold (withheld, with withheldReason): the row is still a real law.
Pass hasText=true for just the laws /{sessionLawId}/body will serve. A row is
the summary only: the full dates, sources and code sections are on
GET /us/session-laws/{sessionLawId}. Each row carries charCount and
estimatedBodyPages, so you can price reading a law before you open it.
citableAs is the law cited the way a lawyer writes it (Minn. Laws 2025, ch. 1), and
licenseNote says what its licence class permits.
Cost of reading a law. Reading a whole law is estimatedBodyPages times the price
of one body page (6 credits). Both are on the record: charCount is its length
in characters and estimatedBodyPages is that divided by the page size (about
30,000 characters), rounded up, and null unless the text is served. Most acts
take a page or two. The longest we hold, Ohio’s 2025 budget act (HB 96, 9,571,132
characters), takes about 320 pages, 1,920 credits to read in
full, so check estimatedBodyPages before you page through an omnibus act. Each body
response then carries pagePrice (what that page cost) and estimatedRemainingCredits
(the pages still to come times the price) so you can stop whenever you have enough.
Example
curl "https://api.vaquill.ai/api/v1/us/session-laws/list?jurisdiction=tx&effectiveFrom=2025-09-01&effectiveTo=2025-09-01&limit=25" \ -H "Authorization: Bearer $VAQUILL_API_KEY"# only what changed since your last sync, and only measures that did not become lawcurl "https://api.vaquill.ai/api/v1/us/session-laws/list?jurisdiction=mn&updatedSince=2026-10-01" \ -H "Authorization: Bearer $VAQUILL_API_KEY"curl "https://api.vaquill.ai/api/v1/us/session-laws/list?jurisdiction=mn&isLaw=false&enactmentOutcome=vetoed&enactmentOutcome=pocket_veto" \ -H "Authorization: Bearer $VAQUILL_API_KEY"# find by words in the title or the printed bill numbercurl "https://api.vaquill.ai/api/v1/us/session-laws/list?jurisdiction=mn&q=court%20fees" -H "Authorization: Bearer $VAQUILL_API_KEY"
GET /us/statutes/resolve answers a citation that names a state session law
rather than a code section with a sessionLaw block (matched, or ambiguous
with every candidate), pointing here. It never changes resolved or section.
GET /us/statutes/coverage lists, per jurisdiction under sessionLaws, which
sessions we hold session laws for and whether each is complete or partial.
Read it first: a law missing from a partial session is not evidence that it
does not exist.
Federal session laws (the Statutes at Large, SAL_ ids) are not served here. Read
them with GET /us/statutes/section/{actId}.
Nulls. Every field of a response is always present: one with no value is null
(or [] for a list). The examples on this page leave the nulls out for brevity. The
exceptions are blocks that exist only when they apply and are OMITTED otherwise, never
null: publisher, provenance and session.coverageStatus on a law, and coverage on a
list page that has rows.
Rate limits. Calls count against your key’s per-minute budget like every Data
API route; a 429 carries Retry-After.
Optional. 16 to 255 visible ASCII characters (a UUIDv4 is ideal). A retry with the same key and the same request replays the original 2xx response for 24 hours without charging again. The same key with a different request is rejected. Scope is the API key, method, path and body. The stored response body is a query-derived cache controlled by the account's data retention setting cacheQueryDerivedData: when it is false the body is never stored and a retry answers 409 idempotency_replay_unavailable, without charging again.
Two-letter code of the state whose session laws to list: the 50 states, dc and pr. Case-insensitive (MN works). Required: the list is scoped to one jurisdiction at a time. federal and any unknown code is a 422; federal session laws are on /us/statutes/section. A jurisdiction we hold no session laws for returns an empty page with a coverage block saying so, which is not charged: see sessionLaws on /us/statutes/coverage for what is held.
Only laws enacted in this session. Use the code exactly as session.code reports it: 2025R is the 2025 regular session, 2025S1 the first special session of 2025. Case-sensitive, so 2025r matches nothing. A code that matches no session returns an empty page (charged), not an error; characters other than letters, digits, ., _ and - are a 422. Omit to list every session.
Only laws in one of these numbering series. Repeat the parameter for several (series=resolve&series=resolves); they combine with OR. general is the ordinary chapter sequence of most states; others number acts, resolutions or local laws apart. One of general, public, public_act, special_act, private_and_special, act, acts, law, local, municipal, appropriation, resolve, resolves, resolution, resolution_chapter, joint_resolution, concurrent_resolution, memorial, initiated_bill, constitutional_amendment, private, constitutional_resolution, competing_measure_resolution, resolution_act, as a result's series reports it. Not every jurisdiction uses every series: sessionLaws on /us/statutes/coverage lists each one's. Any other value is a 422, never charged; a valid series nothing matches returns an empty page (charged). Omit for every series.
Only these kinds of measure. Repeat the parameter for several (instrumentType=joint_resolution&instrumentType=concurrent_resolution); they combine with OR. One of act, joint_resolution, concurrent_resolution, resolution, resolve, memorial, other (act is an ordinary law), as instrumentType reports it. Any other value is a 422, never charged; a valid kind nothing matches returns an empty page (charged). Omit for every kind.
Only laws approved (signed) on or after this date. Format YYYY-MM-DD, inclusive; it must be a real calendar date (2025-02-30 is a 422). A law with no printed approval date never matches, and neither does one whose approvedDate we derived (approvedDateDerived: true): this filter reads the registry's own approval date, so South Dakota's derived dates are not found by it. Pair with approvedTo for a range; an end before the start is a 422 (never charged).
Only laws approved (signed) on or before this date. Format YYYY-MM-DD, inclusive; it must be a real calendar date (2025-02-30 is a 422). Like approvedFrom, it does not match a derived approvedDate.
Only laws with an effective date on or after this date. Format YYYY-MM-DD, inclusive; it must be a real calendar date (2025-02-30 is a 422). A law matches when the span from its first to its last effective date (effectiveFirst to effectiveLast) overlaps your window, so one whose dates straddle your day is returned even though none falls exactly on it: read effectiveDates on the law for the dates themselves. Only laws with a held effective date can match, and not every state's publisher prints them (Texas, Washington and Iowa do; Minnesota does not yet): a law with no effective date is never returned by this filter, though it may well be in force. To get everything taking effect on one day, send the same date to both effectiveFrom and effectiveTo; for example jurisdiction=tx, effectiveFrom=2025-09-01, effectiveTo=2025-09-01 lists the Texas acts effective September 1, 2025.
Only laws with an effective date on or before this date. Format YYYY-MM-DD, inclusive; it must be a real calendar date (2025-02-30 is a 422). Overlap rule as for effectiveFrom. An end before effectiveFrom is a 422 (never charged).
true: only laws whose text is served (textStatus: held), the ones /{sessionLawId}/body will return. false: only laws whose text is not served (withheld, not_held or pending). Omit for both. Combined with textStatus by AND, so hasText=true&textStatus=withheld is always empty. Anything but a boolean is a 422.
Only laws with this text status. One of held, withheld, not_held, pending: held is served, withheld is held but kept back for a measured defect, not_held is known to exist without text, pending is collected and not yet verified. Any other value is a 422. Omit for every status.
true: only measures that are law. false: only numbered measures that are NOT law (a vetoed bill, a pocket veto), the ones isLaw: false marks. Omit for both. A measure whose outcome does not settle it (not_presented, unknown) has a null isLaw, so it matches neither true nor false: use enactmentOutcome for those. Anything but a boolean is a 422.
Only laws with one of these outcomes. Repeat the parameter for several (enactmentOutcome=vetoed&enactmentOutcome=pocket_veto); they combine with OR. One of signed, became_law_without_signature, veto_overridden, line_item_veto, vetoed, pocket_veto, not_presented, approved_by_voters, unknown, as enactmentOutcome reports it. Any other value is a 422, never charged; a valid outcome nothing matches returns an empty page (charged). The order you send them in does not matter, and a cursor stays valid for the same set.
Only laws whose record changed on or after this date, midnight UTC, by updatedAt: the filter for a sync job that pulls only what is new or corrected since its last run. Format YYYY-MM-DD, inclusive; it must be a real calendar date (2025-02-30 is a 422). A day with no change returns an empty page (charged), not an error.
Only laws whose title or printed billNumber contains this text, case-insensitively (grain buyers finds An act relating to agriculture; modifying financial reporting requirements for grain buyers ...). A plain substring, not a search engine: no stemming, no ranking, and % and _ mean themselves. The bill number is matched as the publisher prints it (S.F.No. 1552, not SF 1552): to find a law by citation, use GET /us/session-laws/{sessionLawId}. 3 to 100 characters after trimming and without control characters, else a 422 (never charged); text that matches nothing returns an empty page (charged). Combines with the other filters by AND within the required jurisdiction.
Where to resume: the previous page's nextCursor, unchanged. Send it with the same filters that produced it (limit may change). It is opaque, signed and tied to those filters, and is only ever issued by this API: a value we did not issue is a 422 with reason: invalid_cursor, one from an older cursor format is cursor_expired, and one sent with different filters is cursor_query_mismatch (restart without cursor). Never an empty page. Omit for the first page.
Rows per page, 1 to 200; default 50. A page costs the same however many rows it holds, so a larger limit is cheaper per law. Outside the range is a 422.
Required range: 1 <= x <= 200
Example:
25
Response
A page of the state's session laws. hasMore and nextCursor say whether another follows; an empty results is a charged answer, unless coverage says the session or state is not fully collected.
Credits actually charged for this call, never the list price. It includes the /us/statutes/resolve fee when a citation was sent where an id goes. 0 when the call was not charged or was refunded (a body that answers available: false).
The page of laws, by session.code and then sessionLawId, both as text in the database's collation, not chapter order (so ..._C10 comes before ..._C2; sort by number client-side if you need chapter order). The record without its dates list, sources or text: fetch those with GET /us/session-laws/{sessionLawId}.
Present only on an EMPTY page: what we hold of the session (or state) you asked about, so you can tell nothing matches your filters from we have not collected this. status: complete means the first: the page is charged. partial (the collection stopped short) and not_held (we hold nothing of it) mean the second: the page is NOT charged and creditsConsumed is 0. Omitted when the coverage cannot be read, in which case the empty page is charged as before.
Show child attributes
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Vaquill AI","description":"US primary law as a developer API. The US Code, the CFR, the Federal Register, state and territory statute codes, state regulations, constitutions and court rules, with Bluebook citation resolution and point-in-time retrieval over REST, MCP and SQL.","colors":{"primary":"#6E3730","light":"#8C4A3F","dark":"#5A2D27"},"logo":{"light":"https://mintcdn.com/vaquill/HoYf91pjRoTl4-t3/logo/light.png?fit=max\u0026auto=format\u0026n=HoYf91pjRoTl4-t3\u0026q=85\u0026s=1c97b6018caaa1fee0a743b05651bb81","dark":"https://mintcdn.com/vaquill/HoYf91pjRoTl4-t3/logo/dark.png?fit=max\u0026auto=format\u0026n=HoYf91pjRoTl4-t3\u0026q=85\u0026s=857ee7c2383d363ffe7fac6f94ad862b","href":"https://vaquill.ai"},"favicon":"https://mintcdn.com/vaquill/HoYf91pjRoTl4-t3/favicon.png?fit=max\u0026auto=format\u0026n=HoYf91pjRoTl4-t3\u0026q=85\u0026s=e9fd33556ddcb3576db2925e6f4e27fe","api":{"openapi":"https://api.vaquill.ai/external/openapi.json","playground":{"display":"interactive","proxy":true},"examples":{"defaults":"required","languages":["bash","python","javascript","go"],"prefill":true},"mdx":{"auth":{"method":"bearer","name":"Authorization"},"server":"https://api.vaquill.ai"}},"appearance":{"default":"light","strict":true},"background":{"color":{"light":"#FAFAF9"}},"navbar":{"links":[{"icon":"github","href":"https://vaquill.ai/open-us-law","label":"Open US Law Dataset"},{"href":"mailto:contact@vaquill.ai","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.vaquill.ai"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/vaquill","youtube":"https://www.youtube.com/@vaquill","slack":"https://join.slack.com/t/vaquillaicommunity/shared_invite/zt-3qxv4mtxg-64mtkVe2PxodDMwKGPfvMQ","github":"https://github.com/Vaquill-AI"},"links":[{"header":"Company","items":[{"label":"About","href":"https://vaquill.ai/about"},{"label":"Contact","href":"https://vaquill.ai/contact"},{"label":"Data Sources \u0026 Credits","href":"https://vaquill.ai/partners"},{"label":"Blog","href":"https://vaquill.ai/blog"},{"label":"Engineering","href":"https://vaquill.ai/engineering"}]},{"header":"Developers","items":[{"label":"Data API","href":"https://vaquill.ai/legal-api"},{"label":"MCP Servers","href":"https://vaquill.ai/mcp"},{"label":"API Reference","href":"/api-reference/us-statutes/search-us-statutes-constitutions-court-rules-and-executive-actions"},{"label":"Open US Law Dataset","href":"https://vaquill.ai/open-us-law"}]},{"header":"Legal","items":[{"label":"Privacy Policy","href":"https://vaquill.ai/privacy"},{"label":"Terms of Service","href":"https://vaquill.ai/terms"},{"label":"DPA","href":"https://vaquill.ai/dpa"},{"label":"Cookie Policy","href":"https://vaquill.ai/cookies"},{"label":"Refund Policy","href":"https://vaquill.ai/refund-policy"},{"label":"Delete My Data","href":"https://vaquill.ai/delete-data"},{"label":"Security","href":"https://vaquill.ai/security"},{"label":"Accessibility","href":"https://vaquill.ai/accessibility"},{"label":"Do Not Sell or Share My Personal Information","href":"https://vaquill.ai/privacy"}]}]},"search":{"prompt":"Search docs, guides, and the API reference..."},"seo":{"metatags":{"canonical":"https://www.vaquill.ai/docs","og:site_name":"Vaquill AI Docs","og:locale":"en_US","twitter:card":"summary_large_image","twitter:site":"@vaquillai"},"indexing":"all"},"fonts":{"heading":{"family":"Source Serif 4","weight":400},"body":{"family":"Schibsted Grotesk","weight":400}},"styling":{"eyebrows":"breadcrumbs","codeblocks":{"theme":"github-light"},"latex":false},"errors":{"404":{"redirect":false,"title":"Page not found","description":"That page doesn't exist, or the URL changed. Try the search bar above, or start from the [API overview](/api-guide/overview)."}},"contextual":{"options":["copy","view","assistant","chatgpt","claude","perplexity","cursor","vscode","windsurf","mcp"],"display":"header"},"thumbnails":{"appearance":"light","fonts":{"family":"Source Serif 4"}},"metadata":{"timestamp":true},"navigation":{"global":{"anchors":[{"anchor":"Changelog","icon":"clock","href":"/api-guide/changelog"},{"anchor":"MCP","icon":"plug","href":"/integrations/mcp/vaquill"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"vaquill","hasAudioNarration":false,"actualSubdomain":"vaquill","customDomains":["vaquill.ai"],"gitSource":{"type":"github","owner":"vaquill-ai","repo":"vaquill-ai-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6aeeddf969e61846fb374a5a","clientVersion":"0.0.4087","searchFilterCounts":[{"language":"default","tag":"Guide","count":56},{"language":"default","tag":"US API reference","count":46},{"language":"default","tag":"India API reference","count":30},{"language":"default","tag":"Endpoints","count":28},{"language":"default","tag":"Indian Acts and Legislation","count":18},{"language":"default","tag":"US Statutes","count":18},{"language":"default","tag":"Guides","count":15},{"language":"default","tag":"Core concepts","count":15},{"language":"default","tag":"Integrations","count":14},{"language":"default","tag":"Get started","count":11}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"custom.css","content":":root{--vq-ink: #1c1a17;--vq-muted: #5f5a52;--vq-hairline: #e4e3e0;--vq-raised: #f2f1ef;--vq-radius: 6px}#navbar img{height:3rem;width:auto}footer img{height:3rem;width:auto}#page-title,#content h2,#content h3{font-family:\"Source Serif 4\", Georgia, serif;font-weight:400;letter-spacing:-0.01em;color:var(--vq-ink)}#content h4,#content h5{font-weight:500}.card,.callout,.accordion,.accordion-group,[data-component-part=\"code-block-root\"]{border-radius:var(--vq-radius)!important;box-shadow:none!important}.card,.accordion,.accordion-group{border:1px solid var(--vq-hairline)}.accordion-group .accordion{border:0!important;border-radius:0!important;margin-bottom:0}.accordion-group .accordion+.accordion{border-top:1px solid var(--vq-hairline)!important}.card:hover{border-color:#6e3730!important}.callout{background-color:var(--vq-raised);border:1px solid var(--vq-hairline)}.callout[data-callout-type=\"warning\"]{border-color:#7d5310}.callout[data-callout-type=\"danger\"]{border-color:#a4123c}code,pre,.shiki{font-family:ui-monospace, SFMono-Regular, Menlo, Consolas, monospace}[data-component-part=\"code-block-root\"]{border:1px solid var(--vq-hairline)}"}],"page":{"pagePath":"api-reference/us-session-laws/list-a-states-session-laws","slug":"/api-reference/us-session-laws/list-a-states-session-laws","pageMetadata":{"title":"List a state's session laws","description":"List the session laws of one state: every act its legislature enacted, filtered\nby session, approval date or effective date. This is how you ask \"what became law\nin Texas this session\", \"what was signed in April\" or \"what takes effect on\nSeptember 1, 2025\", and how you turn the answer into `sessionLawId`s for the get\nand body endpoints. A session law is the act as enacted, before it is folded into\na code; v1 serves STATE acts.\n\n**Cost**: 1 credit per page of up to 200 rows (default\n50), however many rows the page holds. An empty page is an answer and is\ncharged when it means nothing matches your filters. A request that fails validation (422)\nis never charged; a failure on our side (500, 503) is refunded.\n\n**Empty pages.** A page with no rows carries `coverage`, what we hold of the session you\nnamed (or of the state, when you named none), so you can tell \"nothing matches\" from \"we\nhave not collected this\". `coverage.status` is `complete` (we hold every law the publisher\nlists for it: the empty page is a true negative, and it is charged), `partial` (the\ncollection stopped short, so the law you want may exist) or `not_held` (we hold nothing of\nit). On `partial` and `not_held` the page is NOT charged and `creditsConsumed` is 0: we\ndo not bill an empty answer that may be our gap. The one exception is a request that\nnames only the state, where some sessions we hold are complete and some partial: the page\nis charged, since for the complete ones it is a true negative, and `coverage.partialSessions`\nnames the sessions to doubt (send one as `session` to ask about it alone). If coverage\ncannot be read the page is charged as before and `coverage` is omitted.\n\n**Filters.** `jurisdiction` is required and scopes everything; the rest narrow it\nand combine with AND. A value that is malformed is a 422, and so is a range whose end is before its\nstart (`approvedTo` before `approvedFrom`, `effectiveTo` before `effectiveFrom`). A value that is well\nformed and matches nothing (an unknown `session`, a date range with no laws) is a\n200 with `results: []`. Dates are `YYYY-MM-DD`.\n\n- Everything from one session: `session` (`2025R`, `2025S1`).\n- Approved in a window: `approvedFrom` / `approvedTo`.\n- Taking effect in a window: `effectiveFrom` / `effectiveTo`. For one day send the\n same date to both. This matches laws whose first-to-last effective dates overlap\n your window, so read `effectiveFirst` and `effectiveLast` on each row and\n `effectiveDates` on the law. A law with no held effective date (not every state\n prints them) never matches.\n- Narrow by `series`, `instrumentType`, `hasText` or `textStatus`.\n- What became law and what did not: `isLaw` (`false` for the vetoed and pocket-vetoed\n measures; a measure whose outcome does not settle it has a null `isLaw` and matches\n neither value) and `enactmentOutcome`, repeated for several outcomes\n (`enactmentOutcome=vetoed\u0026enactmentOutcome=pocket_veto`).\n- A sync job: `updatedSince` returns the laws whose record changed on or after a date\n (midnight UTC, by `updatedAt`), so a job that stores its last run pulls only what is new\n or corrected.\n- Find by words: `q`, a case-insensitive substring of the `title` or the bill number as\n the publisher prints it (3 to 100 characters). It is a substring match inside one\n state, not a search engine.\n- A derived approval date (`approvedDateDerived: true`) is not matched by `approvedFrom`\n and `approvedTo`, which read the registry's own approval date.\n\n**Paging.** Rows come in `session.code` order, then `sessionLawId`, both as TEXT in the\ndatabase's collation, not in chapter order: `..._C10` sorts before `..._C2`, and the id's\nseries and numbering-year segments sort before the chapter. Sort client-side by `number`\nif you need chapter order. The order is the same on every page and for every filter,\nso a cursor never skips or repeats a row. Send\n`nextCursor` back as `cursor`, with the same filters, while `hasMore` is true (a\ncursor sent with different filters is a 422, `cursor_query_mismatch`: restart\nwithout it). The cursor is a keyset (it names the last row you saw), so laws added between your\ncalls never repeat or skip a row you have passed. `count` is the size of this\npage, never a total.\n\n**Text.** Rows include laws whose text we do not hold (`textStatus: not_held`) or\nhold and withhold (`withheld`, with `withheldReason`): the row is still a real law.\nPass `hasText=true` for just the laws `/{sessionLawId}/body` will serve. A row is\nthe summary only: the full dates, sources and code sections are on\n`GET /us/session-laws/{sessionLawId}`. Each row carries `charCount` and\n`estimatedBodyPages`, so you can price reading a law before you open it.\n`citableAs` is the law cited the way a lawyer writes it (`Minn. Laws 2025, ch. 1`), and\n`licenseNote` says what its licence class permits.\n\n**Cost of reading a law.** Reading a whole law is `estimatedBodyPages` times the price\nof one body page (6 credits). Both are on the record: `charCount` is its length\nin characters and `estimatedBodyPages` is that divided by the page size (about\n30,000 characters), rounded up, and null unless the text is served. Most acts\ntake a page or two. The longest we hold, Ohio's 2025 budget act (HB 96, 9,571,132\ncharacters), takes about 320 pages, 1,920 credits to read in\nfull, so check `estimatedBodyPages` before you page through an omnibus act. Each body\nresponse then carries `pagePrice` (what that page cost) and `estimatedRemainingCredits`\n(the pages still to come times the price) so you can stop whenever you have enough.\n\n**Example**\n\n```bash\ncurl \"https://api.vaquill.ai/api/v1/us/session-laws/list?jurisdiction=tx\u0026effectiveFrom=2025-09-01\u0026effectiveTo=2025-09-01\u0026limit=25\" \\\n -H \"Authorization: Bearer $VAQUILL_API_KEY\"\n\n# only what changed since your last sync, and only measures that did not become law\ncurl \"https://api.vaquill.ai/api/v1/us/session-laws/list?jurisdiction=mn\u0026updatedSince=2026-10-01\" \\\n -H \"Authorization: Bearer $VAQUILL_API_KEY\"\ncurl \"https://api.vaquill.ai/api/v1/us/session-laws/list?jurisdiction=mn\u0026isLaw=false\u0026enactmentOutcome=vetoed\u0026enactmentOutcome=pocket_veto\" \\\n -H \"Authorization: Bearer $VAQUILL_API_KEY\"\n\n# find by words in the title or the printed bill number\ncurl \"https://api.vaquill.ai/api/v1/us/session-laws/list?jurisdiction=mn\u0026q=court%20fees\" -H \"Authorization: Bearer $VAQUILL_API_KEY\"\n```\n\n```javascript\nconst url = new URL(\"https://api.vaquill.ai/api/v1/us/session-laws/list\");\nurl.search = new URLSearchParams({ jurisdiction: \"mn\", session: \"2025R\" });\nconst res = await fetch(url, {\n headers: { Authorization: `Bearer ${process.env.VAQUILL_API_KEY}` },\n});\nconst { results, nextCursor, hasMore } = await res.json();\n```\n\n**Related endpoints**\n\n- `GET /us/statutes/resolve` answers a citation that names a state session law\n rather than a code section with a `sessionLaw` block (`matched`, or `ambiguous`\n with every candidate), pointing here. It never changes `resolved` or `section`.\n- `GET /us/statutes/coverage` lists, per jurisdiction under `sessionLaws`, which\n sessions we hold session laws for and whether each is `complete` or `partial`.\n Read it first: a law missing from a `partial` session is not evidence that it\n does not exist.\n- Federal session laws (the Statutes at Large, `SAL_` ids) are not served here. Read\n them with `GET /us/statutes/section/{actId}`.\n\n**Nulls.** Every field of a response is always present: one with no value is `null`\n(or `[]` for a list). The examples on this page leave the nulls out for brevity. The\nexceptions are blocks that exist only when they apply and are OMITTED otherwise, never\nnull: `publisher`, `provenance` and `session.coverageStatus` on a law, and `coverage` on a\nlist page that has rows.\n\n**Rate limits.** Calls count against your key's per-minute budget like every Data\nAPI route; a 429 carries `Retry-After`.","deprecated":null,"version":null,"openapi":"https://api.vaquill.ai/external/openapi.json get /api/v1/us/session-laws/list","href":"/api-reference/us-session-laws/list-a-states-session-laws","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n li: \"li\",\n p: \"p\",\n pre: \"pre\",\n span: \"span\",\n strong: \"strong\",\n ul: \"ul\",\n ..._provideComponents(),\n ...props.components\n }, {CodeBlock} = _components;\n if (!CodeBlock) _missingMdxReference(\"CodeBlock\", true);\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"List the session laws of one state: every act its legislature enacted, filtered\\nby session, approval date or effective date. This is how you ask “what became law\\nin Texas this session”, “what was signed in April” or “what takes effect on\\nSeptember 1, 2025”, and how you turn the answer into \", _jsx(_components.code, {\n children: \"sessionLawId\"\n }), \"s for the get\\nand body endpoints. A session law is the act as enacted, before it is folded into\\na code; v1 serves STATE acts.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Cost\"\n }), \": 1 credit per page of up to 200 rows (default\\n50), however many rows the page holds. An empty page is an answer and is\\ncharged when it means nothing matches your filters. A request that fails validation (422)\\nis never charged; a failure on our side (500, 503) is refunded.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Empty pages.\"\n }), \" A page with no rows carries \", _jsx(_components.code, {\n children: \"coverage\"\n }), \", what we hold of the session you\\nnamed (or of the state, when you named none), so you can tell “nothing matches” from “we\\nhave not collected this”. \", _jsx(_components.code, {\n children: \"coverage.status\"\n }), \" is \", _jsx(_components.code, {\n children: \"complete\"\n }), \" (we hold every law the publisher\\nlists for it: the empty page is a true negative, and it is charged), \", _jsx(_components.code, {\n children: \"partial\"\n }), \" (the\\ncollection stopped short, so the law you want may exist) or \", _jsx(_components.code, {\n children: \"not_held\"\n }), \" (we hold nothing of\\nit). On \", _jsx(_components.code, {\n children: \"partial\"\n }), \" and \", _jsx(_components.code, {\n children: \"not_held\"\n }), \" the page is NOT charged and \", _jsx(_components.code, {\n children: \"creditsConsumed\"\n }), \" is 0: we\\ndo not bill an empty answer that may be our gap. The one exception is a request that\\nnames only the state, where some sessions we hold are complete and some partial: the page\\nis charged, since for the complete ones it is a true negative, and \", _jsx(_components.code, {\n children: \"coverage.partialSessions\"\n }), \"\\nnames the sessions to doubt (send one as \", _jsx(_components.code, {\n children: \"session\"\n }), \" to ask about it alone). If coverage\\ncannot be read the page is charged as before and \", _jsx(_components.code, {\n children: \"coverage\"\n }), \" is omitted.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Filters.\"\n }), \" \", _jsx(_components.code, {\n children: \"jurisdiction\"\n }), \" is required and scopes everything; the rest narrow it\\nand combine with AND. A value that is malformed is a 422, and so is a range whose end is before its\\nstart (\", _jsx(_components.code, {\n children: \"approvedTo\"\n }), \" before \", _jsx(_components.code, {\n children: \"approvedFrom\"\n }), \", \", _jsx(_components.code, {\n children: \"effectiveTo\"\n }), \" before \", _jsx(_components.code, {\n children: \"effectiveFrom\"\n }), \"). A value that is well\\nformed and matches nothing (an unknown \", _jsx(_components.code, {\n children: \"session\"\n }), \", a date range with no laws) is a\\n200 with \", _jsx(_components.code, {\n children: \"results: []\"\n }), \". Dates are \", _jsx(_components.code, {\n children: \"YYYY-MM-DD\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsxs(_components.li, {\n children: [\"Everything from one session: \", _jsx(_components.code, {\n children: \"session\"\n }), \" (\", _jsx(_components.code, {\n children: \"2025R\"\n }), \", \", _jsx(_components.code, {\n children: \"2025S1\"\n }), \").\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [\"Approved in a window: \", _jsx(_components.code, {\n children: \"approvedFrom\"\n }), \" / \", _jsx(_components.code, {\n children: \"approvedTo\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [\"Taking effect in a window: \", _jsx(_components.code, {\n children: \"effectiveFrom\"\n }), \" / \", _jsx(_components.code, {\n children: \"effectiveTo\"\n }), \". For one day send the\\nsame date to both. This matches laws whose first-to-last effective dates overlap\\nyour window, so read \", _jsx(_components.code, {\n children: \"effectiveFirst\"\n }), \" and \", _jsx(_components.code, {\n children: \"effectiveLast\"\n }), \" on each row and\\n\", _jsx(_components.code, {\n children: \"effectiveDates\"\n }), \" on the law. A law with no held effective date (not every state\\nprints them) never matches.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [\"Narrow by \", _jsx(_components.code, {\n children: \"series\"\n }), \", \", _jsx(_components.code, {\n children: \"instrumentType\"\n }), \", \", _jsx(_components.code, {\n children: \"hasText\"\n }), \" or \", _jsx(_components.code, {\n children: \"textStatus\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [\"What became law and what did not: \", _jsx(_components.code, {\n children: \"isLaw\"\n }), \" (\", _jsx(_components.code, {\n children: \"false\"\n }), \" for the vetoed and pocket-vetoed\\nmeasures; a measure whose outcome does not settle it has a null \", _jsx(_components.code, {\n children: \"isLaw\"\n }), \" and matches\\nneither value) and \", _jsx(_components.code, {\n children: \"enactmentOutcome\"\n }), \", repeated for several outcomes\\n(\", _jsx(_components.code, {\n children: \"enactmentOutcome=vetoed\u0026enactmentOutcome=pocket_veto\"\n }), \").\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [\"A sync job: \", _jsx(_components.code, {\n children: \"updatedSince\"\n }), \" returns the laws whose record changed on or after a date\\n(midnight UTC, by \", _jsx(_components.code, {\n children: \"updatedAt\"\n }), \"), so a job that stores its last run pulls only what is new\\nor corrected.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [\"Find by words: \", _jsx(_components.code, {\n children: \"q\"\n }), \", a case-insensitive substring of the \", _jsx(_components.code, {\n children: \"title\"\n }), \" or the bill number as\\nthe publisher prints it (3 to 100 characters). It is a substring match inside one\\nstate, not a search engine.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [\"A derived approval date (\", _jsx(_components.code, {\n children: \"approvedDateDerived: true\"\n }), \") is not matched by \", _jsx(_components.code, {\n children: \"approvedFrom\"\n }), \"\\nand \", _jsx(_components.code, {\n children: \"approvedTo\"\n }), \", which read the registry’s own approval date.\"]\n }), \"\\n\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Paging.\"\n }), \" Rows come in \", _jsx(_components.code, {\n children: \"session.code\"\n }), \" order, then \", _jsx(_components.code, {\n children: \"sessionLawId\"\n }), \", both as TEXT in the\\ndatabase’s collation, not in chapter order: \", _jsx(_components.code, {\n children: \"..._C10\"\n }), \" sorts before \", _jsx(_components.code, {\n children: \"..._C2\"\n }), \", and the id’s\\nseries and numbering-year segments sort before the chapter. Sort client-side by \", _jsx(_components.code, {\n children: \"number\"\n }), \"\\nif you need chapter order. The order is the same on every page and for every filter,\\nso a cursor never skips or repeats a row. Send\\n\", _jsx(_components.code, {\n children: \"nextCursor\"\n }), \" back as \", _jsx(_components.code, {\n children: \"cursor\"\n }), \", with the same filters, while \", _jsx(_components.code, {\n children: \"hasMore\"\n }), \" is true (a\\ncursor sent with different filters is a 422, \", _jsx(_components.code, {\n children: \"cursor_query_mismatch\"\n }), \": restart\\nwithout it). The cursor is a keyset (it names the last row you saw), so laws added between your\\ncalls never repeat or skip a row you have passed. \", _jsx(_components.code, {\n children: \"count\"\n }), \" is the size of this\\npage, never a total.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Text.\"\n }), \" Rows include laws whose text we do not hold (\", _jsx(_components.code, {\n children: \"textStatus: not_held\"\n }), \") or\\nhold and withhold (\", _jsx(_components.code, {\n children: \"withheld\"\n }), \", with \", _jsx(_components.code, {\n children: \"withheldReason\"\n }), \"): the row is still a real law.\\nPass \", _jsx(_components.code, {\n children: \"hasText=true\"\n }), \" for just the laws \", _jsx(_components.code, {\n children: \"/{sessionLawId}/body\"\n }), \" will serve. A row is\\nthe summary only: the full dates, sources and code sections are on\\n\", _jsx(_components.code, {\n children: \"GET /us/session-laws/{sessionLawId}\"\n }), \". Each row carries \", _jsx(_components.code, {\n children: \"charCount\"\n }), \" and\\n\", _jsx(_components.code, {\n children: \"estimatedBodyPages\"\n }), \", so you can price reading a law before you open it.\\n\", _jsx(_components.code, {\n children: \"citableAs\"\n }), \" is the law cited the way a lawyer writes it (\", _jsx(_components.code, {\n children: \"Minn. Laws 2025, ch. 1\"\n }), \"), and\\n\", _jsx(_components.code, {\n children: \"licenseNote\"\n }), \" says what its licence class permits.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Cost of reading a law.\"\n }), \" Reading a whole law is \", _jsx(_components.code, {\n children: \"estimatedBodyPages\"\n }), \" times the price\\nof one body page (6 credits). Both are on the record: \", _jsx(_components.code, {\n children: \"charCount\"\n }), \" is its length\\nin characters and \", _jsx(_components.code, {\n children: \"estimatedBodyPages\"\n }), \" is that divided by the page size (about\\n30,000 characters), rounded up, and null unless the text is served. Most acts\\ntake a page or two. The longest we hold, Ohio’s 2025 budget act (HB 96, 9,571,132\\ncharacters), takes about 320 pages, 1,920 credits to read in\\nfull, so check \", _jsx(_components.code, {\n children: \"estimatedBodyPages\"\n }), \" before you page through an omnibus act. Each body\\nresponse then carries \", _jsx(_components.code, {\n children: \"pagePrice\"\n }), \" (what that page cost) and \", _jsx(_components.code, {\n children: \"estimatedRemainingCredits\"\n }), \"\\n(the pages still to come times the price) so you can stop whenever you have enough.\"]\n }), \"\\n\", _jsx(_components.p, {\n children: _jsx(_components.strong, {\n children: \"Example\"\n })\n }), \"\\n\", _jsx(CodeBlock, {\n numberOfLines: \"11\",\n language: \"shellscript\",\n children: _jsx(_components.pre, {\n className: \"shiki shiki-themes github-light-default dark-plus\",\n style: {\n backgroundColor: \"#ffffff\",\n \"--shiki-dark-bg\": \"#0B0C0E\",\n color: \"#1f2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n language: \"shellscript\",\n children: _jsxs(_components.code, {\n language: \"shellscript\",\n numberOfLines: \"11\",\n children: [_jsxs(_components.span, {\n className: \"line\",\n children: [_jsx(_components.span, {\n style: {\n color: \"#953800\",\n \"--shiki-dark\": \"#DCDCAA\"\n },\n children: \"curl\"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \" \\\"https://api.vaquill.ai/api/v1/us/session-laws/list?jurisdiction=tx\u0026effectiveFrom=2025-09-01\u0026effectiveTo=2025-09-01\u0026limit=25\\\"\"\n }), _jsx(_components.span, {\n style: {\n color: \"#CF222E\",\n \"--shiki-dark\": \"#D7BA7D\"\n },\n children: \" \\\\\"\n })]\n }), \"\\n\", _jsxs(_components.span, {\n className: \"line\",\n children: [_jsx(_components.span, {\n style: {\n color: \"#0550AE\",\n \"--shiki-dark\": \"#569CD6\"\n },\n children: \" -H\"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \" \\\"Authorization: Bearer \"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#9CDCFE\"\n },\n children: \"$VAQUILL_API_KEY\"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \"\\\"\"\n })]\n }), \"\\n\", _jsx(_components.span, {\n className: \"line\"\n }), \"\\n\", _jsx(_components.span, {\n className: \"line\",\n children: _jsx(_components.span, {\n style: {\n color: \"#6E7781\",\n \"--shiki-dark\": \"#6A9955\"\n },\n children: \"# only what changed since your last sync, and only measures that did not become law\"\n })\n }), \"\\n\", _jsxs(_components.span, {\n className: \"line\",\n children: [_jsx(_components.span, {\n style: {\n color: \"#953800\",\n \"--shiki-dark\": \"#DCDCAA\"\n },\n children: \"curl\"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \" \\\"https://api.vaquill.ai/api/v1/us/session-laws/list?jurisdiction=mn\u0026updatedSince=2026-10-01\\\"\"\n }), _jsx(_components.span, {\n style: {\n color: \"#CF222E\",\n \"--shiki-dark\": \"#D7BA7D\"\n },\n children: \" \\\\\"\n })]\n }), \"\\n\", _jsxs(_components.span, {\n className: \"line\",\n children: [_jsx(_components.span, {\n style: {\n color: \"#0550AE\",\n \"--shiki-dark\": \"#569CD6\"\n },\n children: \" -H\"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \" \\\"Authorization: Bearer \"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#9CDCFE\"\n },\n children: \"$VAQUILL_API_KEY\"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \"\\\"\"\n })]\n }), \"\\n\", _jsxs(_components.span, {\n className: \"line\",\n children: [_jsx(_components.span, {\n style: {\n color: \"#953800\",\n \"--shiki-dark\": \"#DCDCAA\"\n },\n children: \"curl\"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \" \\\"https://api.vaquill.ai/api/v1/us/session-laws/list?jurisdiction=mn\u0026isLaw=false\u0026enactmentOutcome=vetoed\u0026enactmentOutcome=pocket_veto\\\"\"\n }), _jsx(_components.span, {\n style: {\n color: \"#CF222E\",\n \"--shiki-dark\": \"#D7BA7D\"\n },\n children: \" \\\\\"\n })]\n }), \"\\n\", _jsxs(_components.span, {\n className: \"line\",\n children: [_jsx(_components.span, {\n style: {\n color: \"#0550AE\",\n \"--shiki-dark\": \"#569CD6\"\n },\n children: \" -H\"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \" \\\"Authorization: Bearer \"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#9CDCFE\"\n },\n children: \"$VAQUILL_API_KEY\"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \"\\\"\"\n })]\n }), \"\\n\", _jsx(_components.span, {\n className: \"line\"\n }), \"\\n\", _jsx(_components.span, {\n className: \"line\",\n children: _jsx(_components.span, {\n style: {\n color: \"#6E7781\",\n \"--shiki-dark\": \"#6A9955\"\n },\n children: \"# find by words in the title or the printed bill number\"\n })\n }), \"\\n\", _jsxs(_components.span, {\n className: \"line\",\n children: [_jsx(_components.span, {\n style: {\n color: \"#953800\",\n \"--shiki-dark\": \"#DCDCAA\"\n },\n children: \"curl\"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \" \\\"https://api.vaquill.ai/api/v1/us/session-laws/list?jurisdiction=mn\u0026q=court%20fees\\\"\"\n }), _jsx(_components.span, {\n style: {\n color: \"#0550AE\",\n \"--shiki-dark\": \"#569CD6\"\n },\n children: \" -H\"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \" \\\"Authorization: Bearer \"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#9CDCFE\"\n },\n children: \"$VAQUILL_API_KEY\"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \"\\\"\"\n })]\n }), \"\\n\"]\n })\n })\n }), \"\\n\", _jsx(CodeBlock, {\n numberOfLines: \"6\",\n language: \"javascript\",\n children: _jsx(_components.pre, {\n className: \"shiki shiki-themes github-light-default dark-plus\",\n style: {\n backgroundColor: \"#ffffff\",\n \"--shiki-dark-bg\": \"#0B0C0E\",\n color: \"#1f2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n language: \"javascript\",\n children: _jsxs(_components.code, {\n language: \"javascript\",\n numberOfLines: \"6\",\n children: [_jsxs(_components.span, {\n className: \"line\",\n children: [_jsx(_components.span, {\n style: {\n color: \"#CF222E\",\n \"--shiki-dark\": \"#569CD6\"\n },\n children: \"const\"\n }), _jsx(_components.span, {\n style: {\n color: \"#0550AE\",\n \"--shiki-dark\": \"#4FC1FF\"\n },\n children: \" url\"\n }), _jsx(_components.span, {\n style: {\n color: \"#CF222E\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \" =\"\n }), _jsx(_components.span, {\n style: {\n color: \"#CF222E\",\n \"--shiki-dark\": \"#569CD6\"\n },\n children: \" new\"\n }), _jsx(_components.span, {\n style: {\n color: \"#8250DF\",\n \"--shiki-dark\": \"#DCDCAA\"\n },\n children: \" URL\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \"(\"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \"\\\"https://api.vaquill.ai/api/v1/us/session-laws/list\\\"\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \");\"\n })]\n }), \"\\n\", _jsxs(_components.span, {\n className: \"line\",\n children: [_jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#9CDCFE\"\n },\n children: \"url\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \".\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#9CDCFE\"\n },\n children: \"search\"\n }), _jsx(_components.span, {\n style: {\n color: \"#CF222E\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \" =\"\n }), _jsx(_components.span, {\n style: {\n color: \"#CF222E\",\n \"--shiki-dark\": \"#569CD6\"\n },\n children: \" new\"\n }), _jsx(_components.span, {\n style: {\n color: \"#8250DF\",\n \"--shiki-dark\": \"#DCDCAA\"\n },\n children: \" URLSearchParams\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \"({ \"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#9CDCFE\"\n },\n children: \"jurisdiction:\"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \" \\\"mn\\\"\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \", \"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#9CDCFE\"\n },\n children: \"session:\"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \" \\\"2025R\\\"\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \" });\"\n })]\n }), \"\\n\", _jsxs(_components.span, {\n className: \"line\",\n children: [_jsx(_components.span, {\n style: {\n color: \"#CF222E\",\n \"--shiki-dark\": \"#569CD6\"\n },\n children: \"const\"\n }), _jsx(_components.span, {\n style: {\n color: \"#0550AE\",\n \"--shiki-dark\": \"#4FC1FF\"\n },\n children: \" res\"\n }), _jsx(_components.span, {\n style: {\n color: \"#CF222E\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \" =\"\n }), _jsx(_components.span, {\n style: {\n color: \"#CF222E\",\n \"--shiki-dark\": \"#C586C0\"\n },\n children: \" await\"\n }), _jsx(_components.span, {\n style: {\n color: \"#8250DF\",\n \"--shiki-dark\": \"#DCDCAA\"\n },\n children: \" fetch\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \"(\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#9CDCFE\"\n },\n children: \"url\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \", {\"\n })]\n }), \"\\n\", _jsxs(_components.span, {\n className: \"line\",\n children: [_jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#9CDCFE\"\n },\n children: \" headers:\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \" { \"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#9CDCFE\"\n },\n children: \"Authorization:\"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \" `Bearer \"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#569CD6\"\n },\n children: \"${\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#9CDCFE\"\n },\n children: \"process\"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \".\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#9CDCFE\"\n },\n children: \"env\"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \".\"\n }), _jsx(_components.span, {\n style: {\n color: \"#0550AE\",\n \"--shiki-dark\": \"#4FC1FF\"\n },\n children: \"VAQUILL_API_KEY\"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#569CD6\"\n },\n children: \"}\"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \"`\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \" },\"\n })]\n }), \"\\n\", _jsx(_components.span, {\n className: \"line\",\n children: _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \"});\"\n })\n }), \"\\n\", _jsxs(_components.span, {\n className: \"line\",\n children: [_jsx(_components.span, {\n style: {\n color: \"#CF222E\",\n \"--shiki-dark\": \"#569CD6\"\n },\n children: \"const\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \" { \"\n }), _jsx(_components.span, {\n style: {\n color: \"#0550AE\",\n \"--shiki-dark\": \"#4FC1FF\"\n },\n children: \"results\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \", \"\n }), _jsx(_components.span, {\n style: {\n color: \"#0550AE\",\n \"--shiki-dark\": \"#4FC1FF\"\n },\n children: \"nextCursor\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \", \"\n }), _jsx(_components.span, {\n style: {\n color: \"#0550AE\",\n \"--shiki-dark\": \"#4FC1FF\"\n },\n children: \"hasMore\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \" } \"\n }), _jsx(_components.span, {\n style: {\n color: \"#CF222E\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \"=\"\n }), _jsx(_components.span, {\n style: {\n color: \"#CF222E\",\n \"--shiki-dark\": \"#C586C0\"\n },\n children: \" await\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#9CDCFE\"\n },\n children: \" res\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \".\"\n }), _jsx(_components.span, {\n style: {\n color: \"#8250DF\",\n \"--shiki-dark\": \"#DCDCAA\"\n },\n children: \"json\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \"();\"\n })]\n }), \"\\n\"]\n })\n })\n }), \"\\n\", _jsx(_components.p, {\n children: _jsx(_components.strong, {\n children: \"Related endpoints\"\n })\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"GET /us/statutes/resolve\"\n }), \" answers a citation that names a state session law\\nrather than a code section with a \", _jsx(_components.code, {\n children: \"sessionLaw\"\n }), \" block (\", _jsx(_components.code, {\n children: \"matched\"\n }), \", or \", _jsx(_components.code, {\n children: \"ambiguous\"\n }), \"\\nwith every candidate), pointing here. It never changes \", _jsx(_components.code, {\n children: \"resolved\"\n }), \" or \", _jsx(_components.code, {\n children: \"section\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"GET /us/statutes/coverage\"\n }), \" lists, per jurisdiction under \", _jsx(_components.code, {\n children: \"sessionLaws\"\n }), \", which\\nsessions we hold session laws for and whether each is \", _jsx(_components.code, {\n children: \"complete\"\n }), \" or \", _jsx(_components.code, {\n children: \"partial\"\n }), \".\\nRead it first: a law missing from a \", _jsx(_components.code, {\n children: \"partial\"\n }), \" session is not evidence that it\\ndoes not exist.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [\"Federal session laws (the Statutes at Large, \", _jsx(_components.code, {\n children: \"SAL_\"\n }), \" ids) are not served here. Read\\nthem with \", _jsx(_components.code, {\n children: \"GET /us/statutes/section/{actId}\"\n }), \".\"]\n }), \"\\n\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Nulls.\"\n }), \" Every field of a response is always present: one with no value is \", _jsx(_components.code, {\n children: \"null\"\n }), \"\\n(or \", _jsx(_components.code, {\n children: \"[]\"\n }), \" for a list). The examples on this page leave the nulls out for brevity. The\\nexceptions are blocks that exist only when they apply and are OMITTED otherwise, never\\nnull: \", _jsx(_components.code, {\n children: \"publisher\"\n }), \", \", _jsx(_components.code, {\n children: \"provenance\"\n }), \" and \", _jsx(_components.code, {\n children: \"session.coverageStatus\"\n }), \" on a law, and \", _jsx(_components.code, {\n children: \"coverage\"\n }), \" on a\\nlist page that has rows.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Rate limits.\"\n }), \" Calls count against your key’s per-minute budget like every Data\\nAPI route; a 429 carries \", _jsx(_components.code, {\n children: \"Retry-After\"\n }), \".\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\nfunction _missingMdxReference(id, component) {\n throw new Error(\"Expected \" + (component ? \"component\" : \"object\") + \" `\" + id + \"` to be defined: you likely forgot to import, pass, or provide it.\");\n}\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"codeStyling":{"theme":"github-light"},"config":{},"pageMetadata":{"title":"List a state's session laws","description":"List the session laws of one state: every act its legislature enacted, filtered\nby session, approval date or effective date. This is how you ask \"what became law\nin Texas this session\", \"what was signed in April\" or \"what takes effect on\nSeptember 1, 2025\", and how you turn the answer into `sessionLawId`s for the get\nand body endpoints. A session law is the act as enacted, before it is folded into\na code; v1 serves STATE acts.\n\n**Cost**: 1 credit per page of up to 200 rows (default\n50), however many rows the page holds. An empty page is an answer and is\ncharged when it means nothing matches your filters. A request that fails validation (422)\nis never charged; a failure on our side (500, 503) is refunded.\n\n**Empty pages.** A page with no rows carries `coverage`, what we hold of the session you\nnamed (or of the state, when you named none), so you can tell \"nothing matches\" from \"we\nhave not collected this\". `coverage.status` is `complete` (we hold every law the publisher\nlists for it: the empty page is a true negative, and it is charged), `partial` (the\ncollection stopped short, so the law you want may exist) or `not_held` (we hold nothing of\nit). On `partial` and `not_held` the page is NOT charged and `creditsConsumed` is 0: we\ndo not bill an empty answer that may be our gap. The one exception is a request that\nnames only the state, where some sessions we hold are complete and some partial: the page\nis charged, since for the complete ones it is a true negative, and `coverage.partialSessions`\nnames the sessions to doubt (send one as `session` to ask about it alone). If coverage\ncannot be read the page is charged as before and `coverage` is omitted.\n\n**Filters.** `jurisdiction` is required and scopes everything; the rest narrow it\nand combine with AND. A value that is malformed is a 422, and so is a range whose end is before its\nstart (`approvedTo` before `approvedFrom`, `effectiveTo` before `effectiveFrom`). A value that is well\nformed and matches nothing (an unknown `session`, a date range with no laws) is a\n200 with `results: []`. Dates are `YYYY-MM-DD`.\n\n- Everything from one session: `session` (`2025R`, `2025S1`).\n- Approved in a window: `approvedFrom` / `approvedTo`.\n- Taking effect in a window: `effectiveFrom` / `effectiveTo`. For one day send the\n same date to both. This matches laws whose first-to-last effective dates overlap\n your window, so read `effectiveFirst` and `effectiveLast` on each row and\n `effectiveDates` on the law. A law with no held effective date (not every state\n prints them) never matches.\n- Narrow by `series`, `instrumentType`, `hasText` or `textStatus`.\n- What became law and what did not: `isLaw` (`false` for the vetoed and pocket-vetoed\n measures; a measure whose outcome does not settle it has a null `isLaw` and matches\n neither value) and `enactmentOutcome`, repeated for several outcomes\n (`enactmentOutcome=vetoed\u0026enactmentOutcome=pocket_veto`).\n- A sync job: `updatedSince` returns the laws whose record changed on or after a date\n (midnight UTC, by `updatedAt`), so a job that stores its last run pulls only what is new\n or corrected.\n- Find by words: `q`, a case-insensitive substring of the `title` or the bill number as\n the publisher prints it (3 to 100 characters). It is a substring match inside one\n state, not a search engine.\n- A derived approval date (`approvedDateDerived: true`) is not matched by `approvedFrom`\n and `approvedTo`, which read the registry's own approval date.\n\n**Paging.** Rows come in `session.code` order, then `sessionLawId`, both as TEXT in the\ndatabase's collation, not in chapter order: `..._C10` sorts before `..._C2`, and the id's\nseries and numbering-year segments sort before the chapter. Sort client-side by `number`\nif you need chapter order. The order is the same on every page and for every filter,\nso a cursor never skips or repeats a row. Send\n`nextCursor` back as `cursor`, with the same filters, while `hasMore` is true (a\ncursor sent with different filters is a 422, `cursor_query_mismatch`: restart\nwithout it). The cursor is a keyset (it names the last row you saw), so laws added between your\ncalls never repeat or skip a row you have passed. `count` is the size of this\npage, never a total.\n\n**Text.** Rows include laws whose text we do not hold (`textStatus: not_held`) or\nhold and withhold (`withheld`, with `withheldReason`): the row is still a real law.\nPass `hasText=true` for just the laws `/{sessionLawId}/body` will serve. A row is\nthe summary only: the full dates, sources and code sections are on\n`GET /us/session-laws/{sessionLawId}`. Each row carries `charCount` and\n`estimatedBodyPages`, so you can price reading a law before you open it.\n`citableAs` is the law cited the way a lawyer writes it (`Minn. Laws 2025, ch. 1`), and\n`licenseNote` says what its licence class permits.\n\n**Cost of reading a law.** Reading a whole law is `estimatedBodyPages` times the price\nof one body page (6 credits). Both are on the record: `charCount` is its length\nin characters and `estimatedBodyPages` is that divided by the page size (about\n30,000 characters), rounded up, and null unless the text is served. Most acts\ntake a page or two. The longest we hold, Ohio's 2025 budget act (HB 96, 9,571,132\ncharacters), takes about 320 pages, 1,920 credits to read in\nfull, so check `estimatedBodyPages` before you page through an omnibus act. Each body\nresponse then carries `pagePrice` (what that page cost) and `estimatedRemainingCredits`\n(the pages still to come times the price) so you can stop whenever you have enough.\n\n**Example**\n\n```bash\ncurl \"https://api.vaquill.ai/api/v1/us/session-laws/list?jurisdiction=tx\u0026effectiveFrom=2025-09-01\u0026effectiveTo=2025-09-01\u0026limit=25\" \\\n -H \"Authorization: Bearer $VAQUILL_API_KEY\"\n\n# only what changed since your last sync, and only measures that did not become law\ncurl \"https://api.vaquill.ai/api/v1/us/session-laws/list?jurisdiction=mn\u0026updatedSince=2026-10-01\" \\\n -H \"Authorization: Bearer $VAQUILL_API_KEY\"\ncurl \"https://api.vaquill.ai/api/v1/us/session-laws/list?jurisdiction=mn\u0026isLaw=false\u0026enactmentOutcome=vetoed\u0026enactmentOutcome=pocket_veto\" \\\n -H \"Authorization: Bearer $VAQUILL_API_KEY\"\n\n# find by words in the title or the printed bill number\ncurl \"https://api.vaquill.ai/api/v1/us/session-laws/list?jurisdiction=mn\u0026q=court%20fees\" -H \"Authorization: Bearer $VAQUILL_API_KEY\"\n```\n\n```javascript\nconst url = new URL(\"https://api.vaquill.ai/api/v1/us/session-laws/list\");\nurl.search = new URLSearchParams({ jurisdiction: \"mn\", session: \"2025R\" });\nconst res = await fetch(url, {\n headers: { Authorization: `Bearer ${process.env.VAQUILL_API_KEY}` },\n});\nconst { results, nextCursor, hasMore } = await res.json();\n```\n\n**Related endpoints**\n\n- `GET /us/statutes/resolve` answers a citation that names a state session law\n rather than a code section with a `sessionLaw` block (`matched`, or `ambiguous`\n with every candidate), pointing here. It never changes `resolved` or `section`.\n- `GET /us/statutes/coverage` lists, per jurisdiction under `sessionLaws`, which\n sessions we hold session laws for and whether each is `complete` or `partial`.\n Read it first: a law missing from a `partial` session is not evidence that it\n does not exist.\n- Federal session laws (the Statutes at Large, `SAL_` ids) are not served here. Read\n them with `GET /us/statutes/section/{actId}`.\n\n**Nulls.** Every field of a response is always present: one with no value is `null`\n(or `[]` for a list). The examples on this page leave the nulls out for brevity. The\nexceptions are blocks that exist only when they apply and are OMITTED otherwise, never\nnull: `publisher`, `provenance` and `session.coverageStatus` on a law, and `coverage` on a\nlist page that has rows.\n\n**Rate limits.** Calls count against your key's per-minute budget like every Data\nAPI route; a 429 carries `Retry-After`.","deprecated":null,"version":null,"openapi":"https://api.vaquill.ai/external/openapi.json get /api/v1/us/session-laws/list","href":"/api-reference/us-session-laws/list-a-states-session-laws","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["US Session Laws"],"summary":"List a state's session laws","description":"List the session laws of one state: every act its legislature enacted, filtered\nby session, approval date or effective date. This is how you ask \"what became law\nin Texas this session\", \"what was signed in April\" or \"what takes effect on\nSeptember 1, 2025\", and how you turn the answer into `sessionLawId`s for the get\nand body endpoints. A session law is the act as enacted, before it is folded into\na code; v1 serves STATE acts.\n\n**Cost**: 1 credit per page of up to 200 rows (default\n50), however many rows the page holds. An empty page is an answer and is\ncharged when it means nothing matches your filters. A request that fails validation (422)\nis never charged; a failure on our side (500, 503) is refunded.\n\n**Empty pages.** A page with no rows carries `coverage`, what we hold of the session you\nnamed (or of the state, when you named none), so you can tell \"nothing matches\" from \"we\nhave not collected this\". `coverage.status` is `complete` (we hold every law the publisher\nlists for it: the empty page is a true negative, and it is charged), `partial` (the\ncollection stopped short, so the law you want may exist) or `not_held` (we hold nothing of\nit). On `partial` and `not_held` the page is NOT charged and `creditsConsumed` is 0: we\ndo not bill an empty answer that may be our gap. The one exception is a request that\nnames only the state, where some sessions we hold are complete and some partial: the page\nis charged, since for the complete ones it is a true negative, and `coverage.partialSessions`\nnames the sessions to doubt (send one as `session` to ask about it alone). If coverage\ncannot be read the page is charged as before and `coverage` is omitted.\n\n**Filters.** `jurisdiction` is required and scopes everything; the rest narrow it\nand combine with AND. A value that is malformed is a 422, and so is a range whose end is before its\nstart (`approvedTo` before `approvedFrom`, `effectiveTo` before `effectiveFrom`). A value that is well\nformed and matches nothing (an unknown `session`, a date range with no laws) is a\n200 with `results: []`. Dates are `YYYY-MM-DD`.\n\n- Everything from one session: `session` (`2025R`, `2025S1`).\n- Approved in a window: `approvedFrom` / `approvedTo`.\n- Taking effect in a window: `effectiveFrom` / `effectiveTo`. For one day send the\n same date to both. This matches laws whose first-to-last effective dates overlap\n your window, so read `effectiveFirst` and `effectiveLast` on each row and\n `effectiveDates` on the law. A law with no held effective date (not every state\n prints them) never matches.\n- Narrow by `series`, `instrumentType`, `hasText` or `textStatus`.\n- What became law and what did not: `isLaw` (`false` for the vetoed and pocket-vetoed\n measures; a measure whose outcome does not settle it has a null `isLaw` and matches\n neither value) and `enactmentOutcome`, repeated for several outcomes\n (`enactmentOutcome=vetoed\u0026enactmentOutcome=pocket_veto`).\n- A sync job: `updatedSince` returns the laws whose record changed on or after a date\n (midnight UTC, by `updatedAt`), so a job that stores its last run pulls only what is new\n or corrected.\n- Find by words: `q`, a case-insensitive substring of the `title` or the bill number as\n the publisher prints it (3 to 100 characters). It is a substring match inside one\n state, not a search engine.\n- A derived approval date (`approvedDateDerived: true`) is not matched by `approvedFrom`\n and `approvedTo`, which read the registry's own approval date.\n\n**Paging.** Rows come in `session.code` order, then `sessionLawId`, both as TEXT in the\ndatabase's collation, not in chapter order: `..._C10` sorts before `..._C2`, and the id's\nseries and numbering-year segments sort before the chapter. Sort client-side by `number`\nif you need chapter order. The order is the same on every page and for every filter,\nso a cursor never skips or repeats a row. Send\n`nextCursor` back as `cursor`, with the same filters, while `hasMore` is true (a\ncursor sent with different filters is a 422, `cursor_query_mismatch`: restart\nwithout it). The cursor is a keyset (it names the last row you saw), so laws added between your\ncalls never repeat or skip a row you have passed. `count` is the size of this\npage, never a total.\n\n**Text.** Rows include laws whose text we do not hold (`textStatus: not_held`) or\nhold and withhold (`withheld`, with `withheldReason`): the row is still a real law.\nPass `hasText=true` for just the laws `/{sessionLawId}/body` will serve. A row is\nthe summary only: the full dates, sources and code sections are on\n`GET /us/session-laws/{sessionLawId}`. Each row carries `charCount` and\n`estimatedBodyPages`, so you can price reading a law before you open it.\n`citableAs` is the law cited the way a lawyer writes it (`Minn. Laws 2025, ch. 1`), and\n`licenseNote` says what its licence class permits.\n\n**Cost of reading a law.** Reading a whole law is `estimatedBodyPages` times the price\nof one body page (6 credits). Both are on the record: `charCount` is its length\nin characters and `estimatedBodyPages` is that divided by the page size (about\n30,000 characters), rounded up, and null unless the text is served. Most acts\ntake a page or two. The longest we hold, Ohio's 2025 budget act (HB 96, 9,571,132\ncharacters), takes about 320 pages, 1,920 credits to read in\nfull, so check `estimatedBodyPages` before you page through an omnibus act. Each body\nresponse then carries `pagePrice` (what that page cost) and `estimatedRemainingCredits`\n(the pages still to come times the price) so you can stop whenever you have enough.\n\n**Example**\n\n```bash\ncurl \"https://api.vaquill.ai/api/v1/us/session-laws/list?jurisdiction=tx\u0026effectiveFrom=2025-09-01\u0026effectiveTo=2025-09-01\u0026limit=25\" \\\n -H \"Authorization: Bearer $VAQUILL_API_KEY\"\n\n# only what changed since your last sync, and only measures that did not become law\ncurl \"https://api.vaquill.ai/api/v1/us/session-laws/list?jurisdiction=mn\u0026updatedSince=2026-10-01\" \\\n -H \"Authorization: Bearer $VAQUILL_API_KEY\"\ncurl \"https://api.vaquill.ai/api/v1/us/session-laws/list?jurisdiction=mn\u0026isLaw=false\u0026enactmentOutcome=vetoed\u0026enactmentOutcome=pocket_veto\" \\\n -H \"Authorization: Bearer $VAQUILL_API_KEY\"\n\n# find by words in the title or the printed bill number\ncurl \"https://api.vaquill.ai/api/v1/us/session-laws/list?jurisdiction=mn\u0026q=court%20fees\" -H \"Authorization: Bearer $VAQUILL_API_KEY\"\n```\n\n```javascript\nconst url = new URL(\"https://api.vaquill.ai/api/v1/us/session-laws/list\");\nurl.search = new URLSearchParams({ jurisdiction: \"mn\", session: \"2025R\" });\nconst res = await fetch(url, {\n headers: { Authorization: `Bearer ${process.env.VAQUILL_API_KEY}` },\n});\nconst { results, nextCursor, hasMore } = await res.json();\n```\n\n**Related endpoints**\n\n- `GET /us/statutes/resolve` answers a citation that names a state session law\n rather than a code section with a `sessionLaw` block (`matched`, or `ambiguous`\n with every candidate), pointing here. It never changes `resolved` or `section`.\n- `GET /us/statutes/coverage` lists, per jurisdiction under `sessionLaws`, which\n sessions we hold session laws for and whether each is `complete` or `partial`.\n Read it first: a law missing from a `partial` session is not evidence that it\n does not exist.\n- Federal session laws (the Statutes at Large, `SAL_` ids) are not served here. Read\n them with `GET /us/statutes/section/{actId}`.\n\n**Nulls.** Every field of a response is always present: one with no value is `null`\n(or `[]` for a list). The examples on this page leave the nulls out for brevity. The\nexceptions are blocks that exist only when they apply and are OMITTED otherwise, never\nnull: `publisher`, `provenance` and `session.coverageStatus` on a law, and `coverage` on a\nlist page that has rows.\n\n**Rate limits.** Calls count against your key's per-minute budget like every Data\nAPI route; a 429 carries `Retry-After`.","operationId":"list_session_laws","parameters":["a5e37ed7-e1a4-4e4c-adcb-9ecb9ebf2840","e31655ac-f221-4b08-9255-594b7b03d2cc","1c2d0bc0-23ef-424d-8f98-c459618ac8a4","72ec6238-6621-4a8d-95fd-c5990aa45a3f","080d91d0-d9dc-4a69-89cb-9ed943065f54","e89db44e-5e5b-4631-9ecf-575a35261e00","223cf973-95bb-4092-a8a9-255888d66ca0","d4e1ec16-a445-4e6e-b3b3-48b61f225437","7d9bb463-5b92-4793-b773-2a6c66fd95e9","06726e9d-843a-4545-b4f2-15d1fb610f58","59731d80-17dd-4f8f-8b33-24436450c730","43714617-982c-41f3-810a-3c1bee295ce9","be1ad0af-7e3c-4c81-8d6d-af01534cf50d","33e0377d-4ce6-4b8a-9680-0155e34dd2aa","afcfedb3-e32f-42dc-9af9-e414ac61c512","4c29e116-7ef9-47c0-a98c-d9e95319010b","5897e5d1-4334-4cb7-9bd3-d9880cb07d8a"],"responses":{"200":"559868ad-0d17-49da-a624-11bdb628e33d","401":"d92aaf2b-01c8-4a23-9510-994bc2993fd7","402":"2f880e04-8914-4190-8cb2-2e0547038634","403":"792ae10f-6032-45c0-8310-1d99bdae770a","409":"30de2c69-bd70-41ad-9623-2cfe648ade23","422":"c46286eb-c2a6-46ae-b912-f30bda70be33","429":"ca8669a0-f5ca-4c6a-ad95-6960bd295c06","500":"6d7c7479-05de-477e-be86-1ba3801b290e","503":"4f3a0241-8015-4569-a989-8b618dd0e65c"},"method":"get","type":"path","servers":["72a9d95a-e7d7-4dbe-946e-0f3975dd0517"],"security":["507a4177-c353-457f-b275-c6e5689326cb","fd51ae53-9413-4b29-a7c2-32a68ced30e6"],"path":"/api/v1/us/session-laws/list","baseUrlOptions":["https://api.vaquill.ai"],"title":"List a state's session laws","codeSamples":[],"requestExampleLanguages":["bash","python","javascript","go"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[]},"dependencies":{"parameters":{"a5e37ed7-e1a4-4e4c-adcb-9ecb9ebf2840":{"name":"jurisdiction","in":"query","required":true,"schema":{"type":"string","description":"Two-letter code of the state whose session laws to list: the 50 states, `dc` and `pr`. Case-insensitive (`MN` works). Required: the list is scoped to one jurisdiction at a time. `federal` and any unknown code is a 422; federal session laws are on `/us/statutes/section`. A jurisdiction we hold no session laws for returns an empty page with a `coverage` block saying so, which is not charged: see `sessionLaws` on `/us/statutes/coverage` for what is held.","examples":["mn"],"enum":["al","ak","as","az","ar","ca","co","ct","de","dc","fl","ga","gu","hi","id","il","in","ia","ks","ky","la","me","md","ma","mi","mn","ms","mo","mt","ne","nv","nh","nj","nm","ny","nc","nd","mp","oh","ok","or","pa","pr","ri","sc","sd","tn","tx","ut","vt","vi","va","wa","wv","wi","wy"],"title":"Jurisdiction","isRequired":true,"uniqueKey":"","typeLabel":"enum\u003cstring>"},"description":"Two-letter code of the state whose session laws to list: the 50 states, `dc` and `pr`. Case-insensitive (`MN` works). Required: the list is scoped to one jurisdiction at a time. `federal` and any unknown code is a 422; federal session laws are on `/us/statutes/section`. A jurisdiction we hold no session laws for returns an empty page with a `coverage` block saying so, which is not charged: see `sessionLaws` on `/us/statutes/coverage` for what is held."},"e31655ac-f221-4b08-9255-594b7b03d2cc":{"name":"session","in":"query","required":false,"schema":{"oneOf":[{"type":"string","title":"Session","description":"Only laws enacted in this session. Use the code exactly as `session.code` reports it: `2025R` is the 2025 regular session, `2025S1` the first special session of 2025. Case-sensitive, so `2025r` matches nothing. A code that matches no session returns an empty page (charged), not an error; characters other than letters, digits, `.`, `_` and `-` are a 422. Omit to list every session.","maxLength":32,"minLength":1,"pattern":"^[A-Za-z0-9._-]+$","example":"2025R","uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","title":"Session","description":"Only laws enacted in this session. Use the code exactly as `session.code` reports it: `2025R` is the 2025 regular session, `2025S1` the first special session of 2025. Case-sensitive, so `2025r` matches nothing. A code that matches no session returns an empty page (charged), not an error; characters other than letters, digits, `.`, `_` and `-` are a 422. Omit to list every session.","example":"2025R","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string | null"},"description":"Only laws enacted in this session. Use the code exactly as `session.code` reports it: `2025R` is the 2025 regular session, `2025S1` the first special session of 2025. Case-sensitive, so `2025r` matches nothing. A code that matches no session returns an empty page (charged), not an error; characters other than letters, digits, `.`, `_` and `-` are a 422. Omit to list every session."},"1c2d0bc0-23ef-424d-8f98-c459618ac8a4":{"name":"series","in":"query","required":false,"schema":{"oneOf":[{"type":"array","items":{"type":"string","enum":["general","public","public_act","special_act","private_and_special","act","acts","law","local","municipal","appropriation","resolve","resolves","resolution","resolution_chapter","joint_resolution","concurrent_resolution","memorial","initiated_bill","constitutional_amendment","private","constitutional_resolution","competing_measure_resolution","resolution_act"],"uniqueKey":"oneOf.0.items.[INDEX]","typeLabel":"enum\u003cstring>"},"title":"Series","description":"Only laws in one of these numbering series. Repeat the parameter for several (`series=resolve\u0026series=resolves`); they combine with OR. `general` is the ordinary chapter sequence of most states; others number acts, resolutions or local laws apart. One of `general`, `public`, `public_act`, `special_act`, `private_and_special`, `act`, `acts`, `law`, `local`, `municipal`, `appropriation`, `resolve`, `resolves`, `resolution`, `resolution_chapter`, `joint_resolution`, `concurrent_resolution`, `memorial`, `initiated_bill`, `constitutional_amendment`, `private`, `constitutional_resolution`, `competing_measure_resolution`, `resolution_act`, as a result's `series` reports it. Not every jurisdiction uses every series: `sessionLaws` on `/us/statutes/coverage` lists each one's. Any other value is a 422, never charged; a valid series nothing matches returns an empty page (charged). Omit for every series.","example":["general"],"uniqueKey":"oneOf.0","typeLabel":"enum\u003cstring>[]"},{"type":"null","title":"Series","description":"Only laws in one of these numbering series. Repeat the parameter for several (`series=resolve\u0026series=resolves`); they combine with OR. `general` is the ordinary chapter sequence of most states; others number acts, resolutions or local laws apart. One of `general`, `public`, `public_act`, `special_act`, `private_and_special`, `act`, `acts`, `law`, `local`, `municipal`, `appropriation`, `resolve`, `resolves`, `resolution`, `resolution_chapter`, `joint_resolution`, `concurrent_resolution`, `memorial`, `initiated_bill`, `constitutional_amendment`, `private`, `constitutional_resolution`, `competing_measure_resolution`, `resolution_act`, as a result's `series` reports it. Not every jurisdiction uses every series: `sessionLaws` on `/us/statutes/coverage` lists each one's. Any other value is a 422, never charged; a valid series nothing matches returns an empty page (charged). Omit for every series.","example":["general"],"uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"enum\u003cstring>[] | null"},"description":"Only laws in one of these numbering series. Repeat the parameter for several (`series=resolve\u0026series=resolves`); they combine with OR. `general` is the ordinary chapter sequence of most states; others number acts, resolutions or local laws apart. One of `general`, `public`, `public_act`, `special_act`, `private_and_special`, `act`, `acts`, `law`, `local`, `municipal`, `appropriation`, `resolve`, `resolves`, `resolution`, `resolution_chapter`, `joint_resolution`, `concurrent_resolution`, `memorial`, `initiated_bill`, `constitutional_amendment`, `private`, `constitutional_resolution`, `competing_measure_resolution`, `resolution_act`, as a result's `series` reports it. Not every jurisdiction uses every series: `sessionLaws` on `/us/statutes/coverage` lists each one's. Any other value is a 422, never charged; a valid series nothing matches returns an empty page (charged). Omit for every series."},"72ec6238-6621-4a8d-95fd-c5990aa45a3f":{"name":"instrumentType","in":"query","required":false,"schema":{"oneOf":[{"type":"array","items":{"type":"string","enum":["act","joint_resolution","concurrent_resolution","resolution","resolve","memorial","other"],"uniqueKey":"oneOf.0.items.[INDEX]","typeLabel":"enum\u003cstring>"},"title":"Instrumenttype","description":"Only these kinds of measure. Repeat the parameter for several (`instrumentType=joint_resolution\u0026instrumentType=concurrent_resolution`); they combine with OR. One of `act`, `joint_resolution`, `concurrent_resolution`, `resolution`, `resolve`, `memorial`, `other` (`act` is an ordinary law), as `instrumentType` reports it. Any other value is a 422, never charged; a valid kind nothing matches returns an empty page (charged). Omit for every kind.","example":["joint_resolution","concurrent_resolution"],"uniqueKey":"oneOf.0","typeLabel":"enum\u003cstring>[]"},{"type":"null","title":"Instrumenttype","description":"Only these kinds of measure. Repeat the parameter for several (`instrumentType=joint_resolution\u0026instrumentType=concurrent_resolution`); they combine with OR. One of `act`, `joint_resolution`, `concurrent_resolution`, `resolution`, `resolve`, `memorial`, `other` (`act` is an ordinary law), as `instrumentType` reports it. Any other value is a 422, never charged; a valid kind nothing matches returns an empty page (charged). Omit for every kind.","example":["joint_resolution","concurrent_resolution"],"uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"enum\u003cstring>[] | null"},"description":"Only these kinds of measure. Repeat the parameter for several (`instrumentType=joint_resolution\u0026instrumentType=concurrent_resolution`); they combine with OR. One of `act`, `joint_resolution`, `concurrent_resolution`, `resolution`, `resolve`, `memorial`, `other` (`act` is an ordinary law), as `instrumentType` reports it. Any other value is a 422, never charged; a valid kind nothing matches returns an empty page (charged). Omit for every kind."},"080d91d0-d9dc-4a69-89cb-9ed943065f54":{"name":"approvedFrom","in":"query","required":false,"schema":{"type":"string","title":"Approvedfrom","description":"Only laws approved (signed) on or after this date. Format `YYYY-MM-DD`, inclusive; it must be a real calendar date (`2025-02-30` is a 422). A law with no printed approval date never matches, and neither does one whose `approvedDate` we derived (`approvedDateDerived: true`): this filter reads the registry's own approval date, so South Dakota's derived dates are not found by it. Pair with `approvedTo` for a range; an end before the start is a 422 (never charged).","format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$","example":"2025-04-01","isRequired":false,"uniqueKey":"","typeLabel":"string\u003cdate>"},"description":"Only laws approved (signed) on or after this date. Format `YYYY-MM-DD`, inclusive; it must be a real calendar date (`2025-02-30` is a 422). A law with no printed approval date never matches, and neither does one whose `approvedDate` we derived (`approvedDateDerived: true`): this filter reads the registry's own approval date, so South Dakota's derived dates are not found by it. Pair with `approvedTo` for a range; an end before the start is a 422 (never charged)."},"e89db44e-5e5b-4631-9ecf-575a35261e00":{"name":"approvedTo","in":"query","required":false,"schema":{"type":"string","title":"Approvedto","description":"Only laws approved (signed) on or before this date. Format `YYYY-MM-DD`, inclusive; it must be a real calendar date (`2025-02-30` is a 422). Like `approvedFrom`, it does not match a derived `approvedDate`.","format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$","example":"2025-05-31","isRequired":false,"uniqueKey":"","typeLabel":"string\u003cdate>"},"description":"Only laws approved (signed) on or before this date. Format `YYYY-MM-DD`, inclusive; it must be a real calendar date (`2025-02-30` is a 422). Like `approvedFrom`, it does not match a derived `approvedDate`."},"223cf973-95bb-4092-a8a9-255888d66ca0":{"name":"effectiveFrom","in":"query","required":false,"schema":{"type":"string","title":"Effectivefrom","description":"Only laws with an effective date on or after this date. Format `YYYY-MM-DD`, inclusive; it must be a real calendar date (`2025-02-30` is a 422). A law matches when the span from its first to its last effective date (`effectiveFirst` to `effectiveLast`) overlaps your window, so one whose dates straddle your day is returned even though none falls exactly on it: read `effectiveDates` on the law for the dates themselves. Only laws with a held effective date can match, and not every state's publisher prints them (Texas, Washington and Iowa do; Minnesota does not yet): a law with no effective date is never returned by this filter, though it may well be in force. To get everything taking effect on one day, send the same date to both `effectiveFrom` and `effectiveTo`; for example `jurisdiction=tx`, `effectiveFrom=2025-09-01`, `effectiveTo=2025-09-01` lists the Texas acts effective September 1, 2025.","format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$","example":"2025-09-01","isRequired":false,"uniqueKey":"","typeLabel":"string\u003cdate>"},"description":"Only laws with an effective date on or after this date. Format `YYYY-MM-DD`, inclusive; it must be a real calendar date (`2025-02-30` is a 422). A law matches when the span from its first to its last effective date (`effectiveFirst` to `effectiveLast`) overlaps your window, so one whose dates straddle your day is returned even though none falls exactly on it: read `effectiveDates` on the law for the dates themselves. Only laws with a held effective date can match, and not every state's publisher prints them (Texas, Washington and Iowa do; Minnesota does not yet): a law with no effective date is never returned by this filter, though it may well be in force. To get everything taking effect on one day, send the same date to both `effectiveFrom` and `effectiveTo`; for example `jurisdiction=tx`, `effectiveFrom=2025-09-01`, `effectiveTo=2025-09-01` lists the Texas acts effective September 1, 2025."},"d4e1ec16-a445-4e6e-b3b3-48b61f225437":{"name":"effectiveTo","in":"query","required":false,"schema":{"type":"string","title":"Effectiveto","description":"Only laws with an effective date on or before this date. Format `YYYY-MM-DD`, inclusive; it must be a real calendar date (`2025-02-30` is a 422). Overlap rule as for `effectiveFrom`. An end before `effectiveFrom` is a 422 (never charged).","format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$","example":"2025-09-30","isRequired":false,"uniqueKey":"","typeLabel":"string\u003cdate>"},"description":"Only laws with an effective date on or before this date. Format `YYYY-MM-DD`, inclusive; it must be a real calendar date (`2025-02-30` is a 422). Overlap rule as for `effectiveFrom`. An end before `effectiveFrom` is a 422 (never charged)."},"7d9bb463-5b92-4793-b773-2a6c66fd95e9":{"name":"hasText","in":"query","required":false,"schema":{"oneOf":[{"type":"boolean","title":"Hastext","description":"`true`: only laws whose text is served (`textStatus: held`), the ones `/{sessionLawId}/body` will return. `false`: only laws whose text is not served (`withheld`, `not_held` or `pending`). Omit for both. Combined with `textStatus` by AND, so `hasText=true\u0026textStatus=withheld` is always empty. Anything but a boolean is a 422.","example":true,"uniqueKey":"oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Hastext","description":"`true`: only laws whose text is served (`textStatus: held`), the ones `/{sessionLawId}/body` will return. `false`: only laws whose text is not served (`withheld`, `not_held` or `pending`). Omit for both. Combined with `textStatus` by AND, so `hasText=true\u0026textStatus=withheld` is always empty. Anything but a boolean is a 422.","example":true,"uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"boolean | null"},"description":"`true`: only laws whose text is served (`textStatus: held`), the ones `/{sessionLawId}/body` will return. `false`: only laws whose text is not served (`withheld`, `not_held` or `pending`). Omit for both. Combined with `textStatus` by AND, so `hasText=true\u0026textStatus=withheld` is always empty. Anything but a boolean is a 422."},"06726e9d-843a-4545-b4f2-15d1fb610f58":{"name":"textStatus","in":"query","required":false,"schema":{"oneOf":[{"type":"string","title":"Textstatus","description":"Only laws with this text status. One of `held`, `withheld`, `not_held`, `pending`: `held` is served, `withheld` is held but kept back for a measured defect, `not_held` is known to exist without text, `pending` is collected and not yet verified. Any other value is a 422. Omit for every status.","enum":["held","withheld","not_held","pending"],"example":"held","uniqueKey":"oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","title":"Textstatus","description":"Only laws with this text status. One of `held`, `withheld`, `not_held`, `pending`: `held` is served, `withheld` is held but kept back for a measured defect, `not_held` is known to exist without text, `pending` is collected and not yet verified. Any other value is a 422. Omit for every status.","example":"held","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"enum\u003cstring> | null"},"description":"Only laws with this text status. One of `held`, `withheld`, `not_held`, `pending`: `held` is served, `withheld` is held but kept back for a measured defect, `not_held` is known to exist without text, `pending` is collected and not yet verified. Any other value is a 422. Omit for every status."},"59731d80-17dd-4f8f-8b33-24436450c730":{"name":"isLaw","in":"query","required":false,"schema":{"oneOf":[{"type":"boolean","title":"Islaw","description":"`true`: only measures that are law. `false`: only numbered measures that are NOT law (a vetoed bill, a pocket veto), the ones `isLaw: false` marks. Omit for both. A measure whose outcome does not settle it (`not_presented`, `unknown`) has a null `isLaw`, so it matches neither `true` nor `false`: use `enactmentOutcome` for those. Anything but a boolean is a 422.","example":false,"uniqueKey":"oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Islaw","description":"`true`: only measures that are law. `false`: only numbered measures that are NOT law (a vetoed bill, a pocket veto), the ones `isLaw: false` marks. Omit for both. A measure whose outcome does not settle it (`not_presented`, `unknown`) has a null `isLaw`, so it matches neither `true` nor `false`: use `enactmentOutcome` for those. Anything but a boolean is a 422.","example":false,"uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"boolean | null"},"description":"`true`: only measures that are law. `false`: only numbered measures that are NOT law (a vetoed bill, a pocket veto), the ones `isLaw: false` marks. Omit for both. A measure whose outcome does not settle it (`not_presented`, `unknown`) has a null `isLaw`, so it matches neither `true` nor `false`: use `enactmentOutcome` for those. Anything but a boolean is a 422."},"43714617-982c-41f3-810a-3c1bee295ce9":{"name":"enactmentOutcome","in":"query","required":false,"schema":{"oneOf":[{"type":"array","items":{"type":"string","enum":["signed","became_law_without_signature","veto_overridden","line_item_veto","vetoed","pocket_veto","not_presented","approved_by_voters","unknown"],"uniqueKey":"oneOf.0.items.[INDEX]","typeLabel":"enum\u003cstring>"},"title":"Enactmentoutcome","description":"Only laws with one of these outcomes. Repeat the parameter for several (`enactmentOutcome=vetoed\u0026enactmentOutcome=pocket_veto`); they combine with OR. One of `signed`, `became_law_without_signature`, `veto_overridden`, `line_item_veto`, `vetoed`, `pocket_veto`, `not_presented`, `approved_by_voters`, `unknown`, as `enactmentOutcome` reports it. Any other value is a 422, never charged; a valid outcome nothing matches returns an empty page (charged). The order you send them in does not matter, and a cursor stays valid for the same set.","example":["vetoed","pocket_veto"],"uniqueKey":"oneOf.0","typeLabel":"enum\u003cstring>[]"},{"type":"null","title":"Enactmentoutcome","description":"Only laws with one of these outcomes. Repeat the parameter for several (`enactmentOutcome=vetoed\u0026enactmentOutcome=pocket_veto`); they combine with OR. One of `signed`, `became_law_without_signature`, `veto_overridden`, `line_item_veto`, `vetoed`, `pocket_veto`, `not_presented`, `approved_by_voters`, `unknown`, as `enactmentOutcome` reports it. Any other value is a 422, never charged; a valid outcome nothing matches returns an empty page (charged). The order you send them in does not matter, and a cursor stays valid for the same set.","example":["vetoed","pocket_veto"],"uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"enum\u003cstring>[] | null"},"description":"Only laws with one of these outcomes. Repeat the parameter for several (`enactmentOutcome=vetoed\u0026enactmentOutcome=pocket_veto`); they combine with OR. One of `signed`, `became_law_without_signature`, `veto_overridden`, `line_item_veto`, `vetoed`, `pocket_veto`, `not_presented`, `approved_by_voters`, `unknown`, as `enactmentOutcome` reports it. Any other value is a 422, never charged; a valid outcome nothing matches returns an empty page (charged). The order you send them in does not matter, and a cursor stays valid for the same set."},"be1ad0af-7e3c-4c81-8d6d-af01534cf50d":{"name":"updatedSince","in":"query","required":false,"schema":{"type":"string","title":"Updatedsince","description":"Only laws whose record changed on or after this date, midnight UTC, by `updatedAt`: the filter for a sync job that pulls only what is new or corrected since its last run. Format `YYYY-MM-DD`, inclusive; it must be a real calendar date (`2025-02-30` is a 422). A day with no change returns an empty page (charged), not an error.","format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$","example":"2026-10-01","isRequired":false,"uniqueKey":"","typeLabel":"string\u003cdate>"},"description":"Only laws whose record changed on or after this date, midnight UTC, by `updatedAt`: the filter for a sync job that pulls only what is new or corrected since its last run. Format `YYYY-MM-DD`, inclusive; it must be a real calendar date (`2025-02-30` is a 422). A day with no change returns an empty page (charged), not an error."},"33e0377d-4ce6-4b8a-9680-0155e34dd2aa":{"name":"q","in":"query","required":false,"schema":{"oneOf":[{"type":"string","title":"Q","description":"Only laws whose `title` or printed `billNumber` contains this text, case-insensitively (`grain buyers` finds `An act relating to agriculture; modifying financial reporting requirements for grain buyers ...`). A plain substring, not a search engine: no stemming, no ranking, and `%` and `_` mean themselves. The bill number is matched as the publisher prints it (`S.F.No. 1552`, not `SF 1552`): to find a law by citation, use `GET /us/session-laws/{sessionLawId}`. 3 to 100 characters after trimming and without control characters, else a 422 (never charged); text that matches nothing returns an empty page (charged). Combines with the other filters by AND within the required `jurisdiction`.","maxLength":100,"minLength":3,"example":"grain buyers","uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","title":"Q","description":"Only laws whose `title` or printed `billNumber` contains this text, case-insensitively (`grain buyers` finds `An act relating to agriculture; modifying financial reporting requirements for grain buyers ...`). A plain substring, not a search engine: no stemming, no ranking, and `%` and `_` mean themselves. The bill number is matched as the publisher prints it (`S.F.No. 1552`, not `SF 1552`): to find a law by citation, use `GET /us/session-laws/{sessionLawId}`. 3 to 100 characters after trimming and without control characters, else a 422 (never charged); text that matches nothing returns an empty page (charged). Combines with the other filters by AND within the required `jurisdiction`.","example":"grain buyers","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string | null"},"description":"Only laws whose `title` or printed `billNumber` contains this text, case-insensitively (`grain buyers` finds `An act relating to agriculture; modifying financial reporting requirements for grain buyers ...`). A plain substring, not a search engine: no stemming, no ranking, and `%` and `_` mean themselves. The bill number is matched as the publisher prints it (`S.F.No. 1552`, not `SF 1552`): to find a law by citation, use `GET /us/session-laws/{sessionLawId}`. 3 to 100 characters after trimming and without control characters, else a 422 (never charged); text that matches nothing returns an empty page (charged). Combines with the other filters by AND within the required `jurisdiction`."},"afcfedb3-e32f-42dc-9af9-e414ac61c512":{"name":"cursor","in":"query","required":false,"schema":{"oneOf":[{"type":"string","title":"Cursor","description":"Where to resume: the previous page's `nextCursor`, unchanged. Send it with the same filters that produced it (`limit` may change). It is opaque, signed and tied to those filters, and is only ever issued by this API: a value we did not issue is a 422 with `reason: invalid_cursor`, one from an older cursor format is `cursor_expired`, and one sent with different filters is `cursor_query_mismatch` (restart without `cursor`). Never an empty page. Omit for the first page.","maxLength":600,"example":"eyJ2IjoyLCJqIjoibW4iLCJzIjoiMjAyNVIiLCJpIjoiU1NMX01OXzIwMjVSX0dfWTIwMjVfQzEwIiwicSI6IjYxMjk2NDEzOTE2OTJmOTYifQ.86d0NXnVAJD7j_3d9zoWPQ","uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","title":"Cursor","description":"Where to resume: the previous page's `nextCursor`, unchanged. Send it with the same filters that produced it (`limit` may change). It is opaque, signed and tied to those filters, and is only ever issued by this API: a value we did not issue is a 422 with `reason: invalid_cursor`, one from an older cursor format is `cursor_expired`, and one sent with different filters is `cursor_query_mismatch` (restart without `cursor`). Never an empty page. Omit for the first page.","example":"eyJ2IjoyLCJqIjoibW4iLCJzIjoiMjAyNVIiLCJpIjoiU1NMX01OXzIwMjVSX0dfWTIwMjVfQzEwIiwicSI6IjYxMjk2NDEzOTE2OTJmOTYifQ.86d0NXnVAJD7j_3d9zoWPQ","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string | null"},"description":"Where to resume: the previous page's `nextCursor`, unchanged. Send it with the same filters that produced it (`limit` may change). It is opaque, signed and tied to those filters, and is only ever issued by this API: a value we did not issue is a 422 with `reason: invalid_cursor`, one from an older cursor format is `cursor_expired`, and one sent with different filters is `cursor_query_mismatch` (restart without `cursor`). Never an empty page. Omit for the first page."},"4c29e116-7ef9-47c0-a98c-d9e95319010b":{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"Rows per page, 1 to 200; default 50. A page costs the same however many rows it holds, so a larger `limit` is cheaper per law. Outside the range is a 422.","examples":[25],"default":50,"title":"Limit","isRequired":false,"uniqueKey":"","typeLabel":"integer"},"description":"Rows per page, 1 to 200; default 50. A page costs the same however many rows it holds, so a larger `limit` is cheaper per law. Outside the range is a 422."},"5897e5d1-4334-4cb7-9bd3-d9880cb07d8a":{"name":"Idempotency-Key","in":"header","required":false,"schema":{"oneOf":[{"type":"string","title":"Idempotency-Key","description":"Optional. 16 to 255 visible ASCII characters (a UUIDv4 is ideal). A retry with the same key and the same request replays the original 2xx response for 24 hours without charging again. The same key with a different request is rejected. Scope is the API key, method, path and body. The stored response body is a query-derived cache controlled by the account's data retention setting cacheQueryDerivedData: when it is false the body is never stored and a retry answers 409 idempotency_replay_unavailable, without charging again.","maxLength":255,"minLength":16,"pattern":"^[\\x21-\\x7e]+$","example":"3f9c2a1e-7b44-4d0a-9c1e-5a6b7c8d9e0f","uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","title":"Idempotency-Key","description":"Optional. 16 to 255 visible ASCII characters (a UUIDv4 is ideal). A retry with the same key and the same request replays the original 2xx response for 24 hours without charging again. The same key with a different request is rejected. Scope is the API key, method, path and body. The stored response body is a query-derived cache controlled by the account's data retention setting cacheQueryDerivedData: when it is false the body is never stored and a retry answers 409 idempotency_replay_unavailable, without charging again.","example":"3f9c2a1e-7b44-4d0a-9c1e-5a6b7c8d9e0f","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string | null"},"description":"Optional. 16 to 255 visible ASCII characters (a UUIDv4 is ideal). A retry with the same key and the same request replays the original 2xx response for 24 hours without charging again. The same key with a different request is rejected. Scope is the API key, method, path and body. The stored response body is a query-derived cache controlled by the account's data retention setting cacheQueryDerivedData: when it is false the body is never stored and a retry answers 409 idempotency_replay_unavailable, without charging again."}},"responses":{"559868ad-0d17-49da-a624-11bdb628e33d":{"description":"A page of the state's session laws. `hasMore` and `nextCursor` say whether another follows; an empty `results` is a charged answer, unless `coverage` says the session or state is not fully collected.","content":{"application/json":{"schema":{"properties":{"processingTimeMs":{"type":"number","title":"Processingtimems","description":"Server-side time for this request in milliseconds, excluding network transit. Not billed on.","default":0,"examples":[747.5],"uniqueKey":"processingTimeMs","typeLabel":"number"},"creditsConsumed":{"type":"integer","title":"Creditsconsumed","description":"Credits actually charged for this call, never the list price. It includes the `/us/statutes/resolve` fee when a citation was sent where an id goes. 0 when the call was not charged or was refunded (a body that answers `available: false`).","default":0,"examples":[2],"uniqueKey":"creditsConsumed","typeLabel":"integer"},"results":{"items":{"properties":{"sessionLawId":{"type":"string","title":"Sessionlawid","description":"Permanent identifier of the law, the key to use everywhere. Shape `SSL_{state}_{session code}_{series}[_Y{numberingYear}]_{C\u003cchapter>|B\u003cbillKey>}`. It never changes: a correction to our reading of a law keeps the old id working. Pass it to `GET /us/session-laws/{sessionLawId}`.","examples":["SSL_MN_2025R_G_Y2025_C1"],"isRequired":true,"uniqueKey":"results.items.[INDEX].sessionLawId","typeLabel":"string"},"jurisdiction":{"type":"string","title":"Jurisdiction","description":"Lowercase two-letter code of the state, `dc` or `pr`. Federal acts are not served by this family: they are on `/us/statutes/section`.","examples":["mn"],"isRequired":true,"uniqueKey":"results.items.[INDEX].jurisdiction","typeLabel":"string"},"citation":{"type":"string","title":"Citation","description":"The act's citation as its publisher prints it, falling back to `{session label}, ch. {number}` when none is printed. It is NOT unique: many states print a bare `CHAPTER 1` every session. Key on `sessionLawId`.","examples":["CHAPTER 1--S.F.No. 1552","ACT No. 2","Chapter 1, Laws of 2025"],"isRequired":true,"uniqueKey":"results.items.[INDEX].citation","typeLabel":"string"},"session":{"properties":{"code":{"type":"string","title":"Code","description":"Session code, `{year}{type}{ordinal}`. `type` is `R` regular, `S` special, `X` extraordinary, `F` fiscal, `V` veto, `U` unknown. A regular session has no ordinal (`2025R`); a numbered special session carries it (`2025S1`, the first special session of 2025); a lettered one carries its letter (`2025SC`, Florida's Special Session C). `year` is the year the publisher numbers the session by, which for a period spanning two years is the first (District of Columbia Council Period 25 is `2023R`). Pass it as `session` to `GET /us/session-laws/list`.","examples":["2025R","2025S1"],"isRequired":true,"uniqueKey":"results.items.[INDEX].session.code","typeLabel":"string"},"label":{"oneOf":[{"type":"string","title":"Label","description":"The session's canonical label, as the publisher names it.","example":"2025 Regular Session","uniqueKey":"results.items.[INDEX].session.label.oneOf.0","typeLabel":"string"},{"type":"null","title":"Label","description":"The session's canonical label, as the publisher names it.","example":"2025 Regular Session","uniqueKey":"results.items.[INDEX].session.label.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].session.label","typeLabel":"string | null"},"type":{"oneOf":[{"type":"string","title":"Type","description":"`regular`, `special`, `extraordinary`, `fiscal`, `veto` or `unknown`.","example":"regular","uniqueKey":"results.items.[INDEX].session.type.oneOf.0","typeLabel":"string"},{"type":"null","title":"Type","description":"`regular`, `special`, `extraordinary`, `fiscal`, `veto` or `unknown`.","example":"regular","uniqueKey":"results.items.[INDEX].session.type.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].session.type","typeLabel":"string | null"},"year":{"oneOf":[{"type":"integer","title":"Year","description":"The year the session convened, the same year `code` starts with.","example":2025,"uniqueKey":"results.items.[INDEX].session.year.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Year","description":"The year the session convened, the same year `code` starts with.","example":2025,"uniqueKey":"results.items.[INDEX].session.year.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].session.year","typeLabel":"integer | null"}},"type":"object","required":["code"],"title":"SessionLawSession","description":"The legislative session the law was enacted in.","isRequired":true,"uniqueKey":"results.items.[INDEX].session","typeLabel":"SessionLawSession · object"},"series":{"type":"string","title":"Series","description":"The numbering series the law belongs to within its session. Most states have one, `general`. Others number acts, resolutions or local laws separately (`public`, `act`, `acts`, `law`, `public_act`, `resolve`, `resolution_chapter`, `local`, ...). An open list that grows as jurisdictions load. Filter with `series` on the list.","examples":["general"],"isRequired":true,"uniqueKey":"results.items.[INDEX].series","typeLabel":"string"},"instrumentType":{"type":"string","title":"Instrumenttype","description":"What kind of measure this is: `act`, `joint_resolution`, `concurrent_resolution`, `resolution`, `resolve`, `memorial` or `other`. An open list. A resolution that was numbered and published among the session laws is included, with `isLaw` saying whether it binds as law.","examples":["act"],"isRequired":true,"uniqueKey":"results.items.[INDEX].instrumentType","typeLabel":"string"},"enactmentOutcome":{"type":"string","title":"Enactmentoutcome","description":"How the measure became, or failed to become, law. `signed`; `became_law_without_signature`; `veto_overridden`; `line_item_veto` (signed with some items vetoed); `vetoed` and `pocket_veto` (not law); `not_presented` (no governor action recorded, usual for resolutions); `approved_by_voters`; `unknown` (the publisher does not say).","examples":["signed"],"isRequired":true,"uniqueKey":"results.items.[INDEX].enactmentOutcome","typeLabel":"string"},"textStatus":{"type":"string","enum":["held","withheld","not_held","pending"],"title":"Textstatus","description":"Whether we serve this law's text. `held`: the text is served by `/us/session-laws/{sessionLawId}/body`. `withheld`: we hold the text but a measured defect keeps it from being served, and `withheldReason` says what. `not_held`: we know the act exists and do not hold its text. `pending`: collected and not yet verified.","examples":["held"],"isRequired":true,"uniqueKey":"results.items.[INDEX].textStatus","typeLabel":"enum\u003cstring>"},"identityConfidence":{"type":"string","title":"Identityconfidence","description":"How firmly the law's identity (session and number) is established. `single_source`: read from one publisher source, which is every state law at launch. `confirmed`: agreed by a second independent source, the level at which a `lawId` can be minted. `inferred`: derived by us rather than printed. `disputed`: sources disagree. The `sessionLawId` is the same at every level.","examples":["single_source"],"isRequired":true,"uniqueKey":"results.items.[INDEX].identityConfidence","typeLabel":"string"},"lawId":{"oneOf":[{"type":"string","title":"Lawid","description":"The law's identifier in the open us1 scheme. Null until its identity is confirmed by a second source and the us1 state shape is minted, so it is null on every state law today. Use `sessionLawId`, which is always present.","example":null,"uniqueKey":"results.items.[INDEX].lawId.oneOf.0","typeLabel":"string"},{"type":"null","title":"Lawid","description":"The law's identifier in the open us1 scheme. Null until its identity is confirmed by a second source and the us1 state shape is minted, so it is null on every state law today. Use `sessionLawId`, which is always present.","example":null,"uniqueKey":"results.items.[INDEX].lawId.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].lawId","typeLabel":"string | null"},"citableAs":{"oneOf":[{"type":"string","title":"Citableas","description":"The law cited the way a lawyer writes it, from the state's own form: `Minn. Laws 2025, ch. 1`, `2025 Fla. Laws ch. 3`, `Ill. Pub. Act 104-0001`, `S.L. 2025-12` (North Carolina), `Stats. 2025, ch. 12` (California), `Ohio S.B. 1 (2025)` for a state that numbers no chapters. A law in a special or extraordinary session carries it (`Minn. Laws 2025, 1st Spec. Sess., ch. 1`). Every value is read back through the grammar that `GET /us/session-laws/{sessionLawId}` accepts a citation in, and must name this law; one that would not is null, never guessed. Null where the state's form is not known, for a series with no standard form (resolutions, memorials), or for a law with neither a chapter nor a bill key. Where a regular and a special session each have a chapter 1, the bare form is the regular session's law and resolves with that law flagged as the default; the special session's carries its session. Distinct from `citation`, which is the publisher's printed form.","example":"Minn. Laws 2025, ch. 1","uniqueKey":"results.items.[INDEX].citableAs.oneOf.0","typeLabel":"string"},{"type":"null","title":"Citableas","description":"The law cited the way a lawyer writes it, from the state's own form: `Minn. Laws 2025, ch. 1`, `2025 Fla. Laws ch. 3`, `Ill. Pub. Act 104-0001`, `S.L. 2025-12` (North Carolina), `Stats. 2025, ch. 12` (California), `Ohio S.B. 1 (2025)` for a state that numbers no chapters. A law in a special or extraordinary session carries it (`Minn. Laws 2025, 1st Spec. Sess., ch. 1`). Every value is read back through the grammar that `GET /us/session-laws/{sessionLawId}` accepts a citation in, and must name this law; one that would not is null, never guessed. Null where the state's form is not known, for a series with no standard form (resolutions, memorials), or for a law with neither a chapter nor a bill key. Where a regular and a special session each have a chapter 1, the bare form is the regular session's law and resolves with that law flagged as the default; the special session's carries its session. Distinct from `citation`, which is the publisher's printed form.","example":"Minn. Laws 2025, ch. 1","uniqueKey":"results.items.[INDEX].citableAs.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].citableAs","typeLabel":"string | null"},"citationShort":{"oneOf":[{"type":"string","title":"Citationshort","description":"A compact label for tables and badges: `MN ch. 1 (2025)`, `IL P.A. 104-0001`, `OH S.B. 1 (2025)`. Not a form to send back: use `citableAs` or the `sessionLawId`. Null exactly when `citableAs` is null.","example":"MN ch. 1 (2025)","uniqueKey":"results.items.[INDEX].citationShort.oneOf.0","typeLabel":"string"},{"type":"null","title":"Citationshort","description":"A compact label for tables and badges: `MN ch. 1 (2025)`, `IL P.A. 104-0001`, `OH S.B. 1 (2025)`. Not a form to send back: use `citableAs` or the `sessionLawId`. Null exactly when `citableAs` is null.","example":"MN ch. 1 (2025)","uniqueKey":"results.items.[INDEX].citationShort.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].citationShort","typeLabel":"string | null"},"number":{"oneOf":[{"type":"string","title":"Number","description":"The chapter or act number exactly as printed, as a string. It is not always an integer: `1`, `2025-12` (Florida), `104-0001` (Illinois), `1A`. Null where the state does not number its acts (see `billKey`).","example":"1","uniqueKey":"results.items.[INDEX].number.oneOf.0","typeLabel":"string"},{"type":"null","title":"Number","description":"The chapter or act number exactly as printed, as a string. It is not always an integer: `1`, `2025-12` (Florida), `104-0001` (Illinois), `1A`. Null where the state does not number its acts (see `billKey`).","example":"1","uniqueKey":"results.items.[INDEX].number.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].number","typeLabel":"string | null"},"billKey":{"oneOf":[{"type":"string","title":"Billkey","description":"Normalised bill identifier (chamber and type letters plus the number) that stands in for a chapter number in states that do not number their acts (Missouri, Ohio, Nebraska). `House Bill 2` is `HB2`. Null whenever `number` is set. Part of the `sessionLawId` as `B\u003cbillKey>`.","example":"HB2","uniqueKey":"results.items.[INDEX].billKey.oneOf.0","typeLabel":"string"},{"type":"null","title":"Billkey","description":"Normalised bill identifier (chamber and type letters plus the number) that stands in for a chapter number in states that do not number their acts (Missouri, Ohio, Nebraska). `House Bill 2` is `HB2`. Null whenever `number` is set. Part of the `sessionLawId` as `B\u003cbillKey>`.","example":"HB2","uniqueKey":"results.items.[INDEX].billKey.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].billKey","typeLabel":"string | null"},"billNumber":{"oneOf":[{"type":"string","title":"Billnumber","description":"The bill the act originated as, as the publisher prints it. Matches as a citation on `GET /us/session-laws/{sessionLawId}`.","example":"S.F.No. 1552","uniqueKey":"results.items.[INDEX].billNumber.oneOf.0","typeLabel":"string"},{"type":"null","title":"Billnumber","description":"The bill the act originated as, as the publisher prints it. Matches as a citation on `GET /us/session-laws/{sessionLawId}`.","example":"S.F.No. 1552","uniqueKey":"results.items.[INDEX].billNumber.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].billNumber","typeLabel":"string | null"},"numberingYear":{"oneOf":[{"type":"integer","title":"Numberingyear","description":"The year of the numbering sequence the chapter number belongs to, where the state numbers by year (Minnesota, Florida, Texas). It appears in the `sessionLawId` as `_Y2025`. A chapter number is only unique within a session and numbering year: Minnesota's regular and first special sessions of 2025 each have a Chapter 1. Null where one sequence runs across the session (Louisiana).","example":2025,"uniqueKey":"results.items.[INDEX].numberingYear.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Numberingyear","description":"The year of the numbering sequence the chapter number belongs to, where the state numbers by year (Minnesota, Florida, Texas). It appears in the `sessionLawId` as `_Y2025`. A chapter number is only unique within a session and numbering year: Minnesota's regular and first special sessions of 2025 each have a Chapter 1. Null where one sequence runs across the session (Louisiana).","example":2025,"uniqueKey":"results.items.[INDEX].numberingYear.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].numberingYear","typeLabel":"integer | null"},"title":{"oneOf":[{"type":"string","title":"Title","description":"The act's long title as printed, usually beginning `An act relating to`. It names the code sections the act amends in prose.","example":"An act relating to agriculture; modifying financial reporting requirements for grain buyers; amending Minnesota Statutes 2024, section 223.17, subdivision 6.","uniqueKey":"results.items.[INDEX].title.oneOf.0","typeLabel":"string"},{"type":"null","title":"Title","description":"The act's long title as printed, usually beginning `An act relating to`. It names the code sections the act amends in prose.","example":"An act relating to agriculture; modifying financial reporting requirements for grain buyers; amending Minnesota Statutes 2024, section 223.17, subdivision 6.","uniqueKey":"results.items.[INDEX].title.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].title","typeLabel":"string | null"},"shortTitle":{"oneOf":[{"type":"string","title":"Shorttitle","description":"The act's short title when the publisher gives one (Ohio, New York, the District of Columbia and a few others do), otherwise null.","example":"Enact Advance Ohio Higher Education Act","uniqueKey":"results.items.[INDEX].shortTitle.oneOf.0","typeLabel":"string"},{"type":"null","title":"Shorttitle","description":"The act's short title when the publisher gives one (Ohio, New York, the District of Columbia and a few others do), otherwise null.","example":"Enact Advance Ohio Higher Education Act","uniqueKey":"results.items.[INDEX].shortTitle.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].shortTitle","typeLabel":"string | null"},"approvedDate":{"oneOf":[{"type":"string","title":"Approveddate","description":"Date the governor (or the equivalent authority) approved the act, ISO 8601. Never an effective date: an act is usually in force on a different day, which is `effectiveDates`. Null when the publisher prints no approval date. Where the registry holds none but the publisher's own dated label on `otherDates` names the governor's signature, it is filled from that label and `approvedDateDerived` is true. The `approvedFrom` and `approvedTo` filters do NOT match a derived date: they read the registry's own approval date.","format":"date","example":"2025-03-17","uniqueKey":"results.items.[INDEX].approvedDate.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","title":"Approveddate","description":"Date the governor (or the equivalent authority) approved the act, ISO 8601. Never an effective date: an act is usually in force on a different day, which is `effectiveDates`. Null when the publisher prints no approval date. Where the registry holds none but the publisher's own dated label on `otherDates` names the governor's signature, it is filled from that label and `approvedDateDerived` is true. The `approvedFrom` and `approvedTo` filters do NOT match a derived date: they read the registry's own approval date.","example":"2025-03-17","uniqueKey":"results.items.[INDEX].approvedDate.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].approvedDate","typeLabel":"string\u003cdate> | null"},"approvedDateDerived":{"type":"boolean","title":"Approveddatederived","description":"True only when `approvedDate` was not held as an approval date and we filled it from a dated label printed on the act (today South Dakota's `Signed by the Governor`, listed under `otherDates`), on an act whose `enactmentOutcome` is `signed` or `line_item_veto`. False when `approvedDate` is null or is the registry's own. We never read a `presented` or `passed` date as an approval, nor a signing label on an act that became law without signature.","default":false,"examples":[false,true],"uniqueKey":"results.items.[INDEX].approvedDateDerived","typeLabel":"boolean"},"effectiveFirst":{"oneOf":[{"type":"string","title":"Effectivefirst","description":"Earliest of the act's effective dates we hold. Null when we hold none: a date the publisher does not print, or prints as a relative rule (`the day following final enactment`), is not guessed. The full list is `effectiveDates` on `GET /us/session-laws/{sessionLawId}`.","format":"date","example":"2025-09-01","uniqueKey":"results.items.[INDEX].effectiveFirst.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","title":"Effectivefirst","description":"Earliest of the act's effective dates we hold. Null when we hold none: a date the publisher does not print, or prints as a relative rule (`the day following final enactment`), is not guessed. The full list is `effectiveDates` on `GET /us/session-laws/{sessionLawId}`.","example":"2025-09-01","uniqueKey":"results.items.[INDEX].effectiveFirst.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].effectiveFirst","typeLabel":"string\u003cdate> | null"},"effectiveLast":{"oneOf":[{"type":"string","title":"Effectivelast","description":"Latest of the act's effective dates we hold. Equal to `effectiveFirst` for an act with one date; null when we hold none.","format":"date","example":"2026-01-01","uniqueKey":"results.items.[INDEX].effectiveLast.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","title":"Effectivelast","description":"Latest of the act's effective dates we hold. Equal to `effectiveFirst` for an act with one date; null when we hold none.","example":"2026-01-01","uniqueKey":"results.items.[INDEX].effectiveLast.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].effectiveLast","typeLabel":"string\u003cdate> | null"},"isLaw":{"oneOf":[{"type":"boolean","title":"Islaw","description":"True for an act that is law. False for a numbered measure that is not: a vetoed bill, a pocket veto. Null when `enactmentOutcome` does not settle it (`not_presented`, `unknown`).","example":true,"uniqueKey":"results.items.[INDEX].isLaw.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Islaw","description":"True for an act that is law. False for a numbered measure that is not: a vetoed bill, a pocket veto. Null when `enactmentOutcome` does not settle it (`not_presented`, `unknown`).","example":true,"uniqueKey":"results.items.[INDEX].isLaw.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].isLaw","typeLabel":"boolean | null"},"withheldReason":{"oneOf":[{"type":"string","title":"Withheldreason","description":"Present only when `textStatus` is `withheld`: a plain sentence saying what is wrong with the text we hold and what would release it. Free text, not an enum: show it, do not branch on it. The record itself (dates, sources, title) is still served and still correct.","example":"LA: struck (deleted) law is merged into the text as if current while the record declares the markup preserved or absent (audit 2026-10-03). Awaiting a re-run with strike and underline recovery.","uniqueKey":"results.items.[INDEX].withheldReason.oneOf.0","typeLabel":"string"},{"type":"null","title":"Withheldreason","description":"Present only when `textStatus` is `withheld`: a plain sentence saying what is wrong with the text we hold and what would release it. Free text, not an enum: show it, do not branch on it. The record itself (dates, sources, title) is still served and still correct.","example":"LA: struck (deleted) law is merged into the text as if current while the record declares the markup preserved or absent (audit 2026-10-03). Awaiting a re-run with strike and underline recovery.","uniqueKey":"results.items.[INDEX].withheldReason.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].withheldReason","typeLabel":"string | null"},"charCount":{"oneOf":[{"type":"integer","title":"Charcount","description":"Length of the law's full text in characters, the same as `totalChars` on the body. Null when there is no text. It is reported for a withheld law too (a fact about the text we hold), though that text is not served.","example":5470,"uniqueKey":"results.items.[INDEX].charCount.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Charcount","description":"Length of the law's full text in characters, the same as `totalChars` on the body. Null when there is no text. It is reported for a withheld law too (a fact about the text we hold), though that text is not served.","example":5470,"uniqueKey":"results.items.[INDEX].charCount.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].charCount","typeLabel":"integer | null"},"estimatedBodyPages":{"oneOf":[{"type":"integer","title":"Estimatedbodypages","description":"How many body pages the text takes: `charCount` divided by the page size (30,000 characters), rounded up. Pages are cut back to a paragraph break, so a long act can run a few percent over. Null unless `textStatus` is `held`: there is nothing to read. Reading a whole law costs `estimatedBodyPages` times the price of one body page (6 credits per page on `GET /us/session-laws/{sessionLawId}/body`). Ohio's 2025 budget act (HB 96) is 9,571,132 characters, about 320 pages or 1,920 credits to read in full; most acts are a page or two.","example":1,"uniqueKey":"results.items.[INDEX].estimatedBodyPages.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Estimatedbodypages","description":"How many body pages the text takes: `charCount` divided by the page size (30,000 characters), rounded up. Pages are cut back to a paragraph break, so a long act can run a few percent over. Null unless `textStatus` is `held`: there is nothing to read. Reading a whole law costs `estimatedBodyPages` times the price of one body page (6 credits per page on `GET /us/session-laws/{sessionLawId}/body`). Ohio's 2025 budget act (HB 96) is 9,571,132 characters, about 320 pages or 1,920 credits to read in full; most acts are a page or two.","example":1,"uniqueKey":"results.items.[INDEX].estimatedBodyPages.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].estimatedBodyPages","typeLabel":"integer | null"},"textSha256":{"oneOf":[{"type":"string","title":"Textsha256","description":"SHA-256 (hex) of the full text of this law. It changes only when the text does, so it is the cheap way to tell whether a copy you hold is current. Body pages carry the same value.","example":"55c7a8d08647e41f87e23fc2016881a6583911a1d5cfa8687403442e9096451b","uniqueKey":"results.items.[INDEX].textSha256.oneOf.0","typeLabel":"string"},{"type":"null","title":"Textsha256","description":"SHA-256 (hex) of the full text of this law. It changes only when the text does, so it is the cheap way to tell whether a copy you hold is current. Body pages carry the same value.","example":"55c7a8d08647e41f87e23fc2016881a6583911a1d5cfa8687403442e9096451b","uniqueKey":"results.items.[INDEX].textSha256.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].textSha256","typeLabel":"string | null"},"versionNo":{"oneOf":[{"type":"integer","title":"Versionno","description":"Revision counter of our record of this law: 1 for the first collection, higher after a re-collection changed the text or the metadata. Not a legislative version.","example":1,"uniqueKey":"results.items.[INDEX].versionNo.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Versionno","description":"Revision counter of our record of this law: 1 for the first collection, higher after a re-collection changed the text or the metadata. Not a legislative version.","example":1,"uniqueKey":"results.items.[INDEX].versionNo.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].versionNo","typeLabel":"integer | null"},"amendatoryMarkup":{"oneOf":[{"type":"string","title":"Amendatorymarkup","description":"Whether the language an amending act strikes and inserts survives in the text. `preserved`: it is in `text`, in the convention `markupConvention` names. `lost`: the publisher printed it and our text does not keep it, so deleted words can read as law: check the source before quoting. `absent`: the act carries no such markup that we found. `not_applicable`: there is no text to carry it.","example":"preserved","uniqueKey":"results.items.[INDEX].amendatoryMarkup.oneOf.0","typeLabel":"string"},{"type":"null","title":"Amendatorymarkup","description":"Whether the language an amending act strikes and inserts survives in the text. `preserved`: it is in `text`, in the convention `markupConvention` names. `lost`: the publisher printed it and our text does not keep it, so deleted words can read as law: check the source before quoting. `absent`: the act carries no such markup that we found. `not_applicable`: there is no text to carry it.","example":"preserved","uniqueKey":"results.items.[INDEX].amendatoryMarkup.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].amendatoryMarkup","typeLabel":"string | null"},"markupConvention":{"oneOf":[{"type":"string","title":"Markupconvention","description":"How preserved markup is written, set only when `amendatoryMarkup` is `preserved`. `wdiff`: deleted language is `[-like this-]` and inserted language `{+like this+}`. `publisher_literal`: the publisher's own words are left as printed (Minnesota prints `new text begin` / `new text end` and `deleted text begin` / `deleted text end` markers). `mixed`: both in one text.","example":"publisher_literal","uniqueKey":"results.items.[INDEX].markupConvention.oneOf.0","typeLabel":"string"},{"type":"null","title":"Markupconvention","description":"How preserved markup is written, set only when `amendatoryMarkup` is `preserved`. `wdiff`: deleted language is `[-like this-]` and inserted language `{+like this+}`. `publisher_literal`: the publisher's own words are left as printed (Minnesota prints `new text begin` / `new text end` and `deleted text begin` / `deleted text end` markers). `mixed`: both in one text.","example":"publisher_literal","uniqueKey":"results.items.[INDEX].markupConvention.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].markupConvention","typeLabel":"string | null"},"documentKind":{"oneOf":[{"type":"string","title":"Documentkind","description":"What kind of document the text was taken from: `session_law_print` (the publisher's printed chapter), `enrolled_bill`, `slip_law`, `volume_extract` (carved out of a bound volume) or `other`. An open list. Null when there is no text.","example":"session_law_print","uniqueKey":"results.items.[INDEX].documentKind.oneOf.0","typeLabel":"string"},{"type":"null","title":"Documentkind","description":"What kind of document the text was taken from: `session_law_print` (the publisher's printed chapter), `enrolled_bill`, `slip_law`, `volume_extract` (carved out of a bound volume) or `other`. An open list. Null when there is no text.","example":"session_law_print","uniqueKey":"results.items.[INDEX].documentKind.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].documentKind","typeLabel":"string | null"},"officialUrl":{"oneOf":[{"type":"string","title":"Officialurl","description":"The PUBLISHER's page for this act, never a Vaquill URL: where a person goes to read the act at its legislature. Where the legislature keeps one page per bill (California, Virginia, New York) it is that page, rebuilt from the session and bill number, so it is present for a law we hold back or only know of. Elsewhere it is the government file the text was collected from (`sourceUrl`), which can be a volume covering many acts. `officialUrlBasis` says which. Null when we hold neither. Our own copy of the text is `GET /us/session-laws/{sessionLawId}/body`, a Vaquill service, and is never reported here.","example":"https://www.nysenate.gov/legislation/bills/2025/A414","uniqueKey":"results.items.[INDEX].officialUrl.oneOf.0","typeLabel":"string"},{"type":"null","title":"Officialurl","description":"The PUBLISHER's page for this act, never a Vaquill URL: where a person goes to read the act at its legislature. Where the legislature keeps one page per bill (California, Virginia, New York) it is that page, rebuilt from the session and bill number, so it is present for a law we hold back or only know of. Elsewhere it is the government file the text was collected from (`sourceUrl`), which can be a volume covering many acts. `officialUrlBasis` says which. Null when we hold neither. Our own copy of the text is `GET /us/session-laws/{sessionLawId}/body`, a Vaquill service, and is never reported here.","example":"https://www.nysenate.gov/legislation/bills/2025/A414","uniqueKey":"results.items.[INDEX].officialUrl.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].officialUrl","typeLabel":"string | null"},"officialUrlBasis":{"oneOf":[{"type":"string","title":"Officialurlbasis","description":"How `officialUrl` was found: `bill_page` (the publisher's page for this one act) or `text_source` (the government file the text came from, possibly shared by many acts). Null with `officialUrl`.","example":"bill_page","uniqueKey":"results.items.[INDEX].officialUrlBasis.oneOf.0","typeLabel":"string"},{"type":"null","title":"Officialurlbasis","description":"How `officialUrl` was found: `bill_page` (the publisher's page for this one act) or `text_source` (the government file the text came from, possibly shared by many acts). Null with `officialUrl`.","example":"bill_page","uniqueKey":"results.items.[INDEX].officialUrlBasis.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].officialUrlBasis","typeLabel":"string | null"},"licenseNote":{"oneOf":[{"type":"string","title":"Licensenote","description":"What the law's licence class is and what it means for reuse, in a plain sentence: `Government public: published by a government body with no restrictive terms, so the text may be reused, including commercially.` Every law served with text is of a class that permits reuse; a note saying otherwise describes a record whose text is held back. Free text to show, not an enum to branch on: branch on `textStatus`.","example":"Government public: published by a government body with no restrictive terms, so the text may be reused, including commercially.","uniqueKey":"results.items.[INDEX].licenseNote.oneOf.0","typeLabel":"string"},{"type":"null","title":"Licensenote","description":"What the law's licence class is and what it means for reuse, in a plain sentence: `Government public: published by a government body with no restrictive terms, so the text may be reused, including commercially.` Every law served with text is of a class that permits reuse; a note saying otherwise describes a record whose text is held back. Free text to show, not an enum to branch on: branch on `textStatus`.","example":"Government public: published by a government body with no restrictive terms, so the text may be reused, including commercially.","uniqueKey":"results.items.[INDEX].licenseNote.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].licenseNote","typeLabel":"string | null"},"updatedAt":{"oneOf":[{"type":"string","title":"Updatedat","description":"When this law's record last changed in our registry, ISO 8601 UTC with a `+00:00` offset, the same form as the statutes routes. Use it with `updatedSince` on the list to sync only what changed.","example":"2026-10-05T09:06:39.998043+00:00","uniqueKey":"results.items.[INDEX].updatedAt.oneOf.0","typeLabel":"string"},{"type":"null","title":"Updatedat","description":"When this law's record last changed in our registry, ISO 8601 UTC with a `+00:00` offset, the same form as the statutes routes. Use it with `updatedSince` on the list to sync only what changed.","example":"2026-10-05T09:06:39.998043+00:00","uniqueKey":"results.items.[INDEX].updatedAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].updatedAt","typeLabel":"string | null"}},"type":"object","required":["sessionLawId","jurisdiction","citation","session","series","instrumentType","enactmentOutcome","textStatus","identityConfidence"],"title":"SessionLawSummary","description":"One session law, as it appears in lists and citation results.","uniqueKey":"results.items.[INDEX]","typeLabel":"SessionLawSummary · object"},"type":"array","title":"Results","description":"The page of laws, by `session.code` and then `sessionLawId`, both as text in the database's collation, not chapter order (so `..._C10` comes before `..._C2`; sort by `number` client-side if you need chapter order). The record without its dates list, sources or text: fetch those with `GET /us/session-laws/{sessionLawId}`.","uniqueKey":"results","typeLabel":"SessionLawSummary · object[]"},"count":{"type":"integer","title":"Count","description":"Rows on this page. Never a total: the list is paged by cursor and has no corpus-wide count.","default":0,"examples":[25],"uniqueKey":"count","typeLabel":"integer"},"nextCursor":{"oneOf":[{"type":"string","title":"Nextcursor","description":"Opaque cursor for the next page: send it as `cursor`, with the same filters. Null on the last page.","example":"eyJ2IjoxLCJqIjoibW4iLCJzIjoiMjAyNVIiLCJpIjoiU1NMX01OXzIwMjVSX0dfWTIwMjVfQzEzIn0","uniqueKey":"nextCursor.oneOf.0","typeLabel":"string"},{"type":"null","title":"Nextcursor","description":"Opaque cursor for the next page: send it as `cursor`, with the same filters. Null on the last page.","example":"eyJ2IjoxLCJqIjoibW4iLCJzIjoiMjAyNVIiLCJpIjoiU1NMX01OXzIwMjVSX0dfWTIwMjVfQzEzIn0","uniqueKey":"nextCursor.oneOf.1","typeLabel":"null"}],"uniqueKey":"nextCursor","typeLabel":"string | null"},"hasMore":{"type":"boolean","title":"Hasmore","description":"True when another page follows. Each page is charged, an empty one included, except an empty page that `coverage` reports as a gap in our collection.","default":false,"examples":[true],"uniqueKey":"hasMore","typeLabel":"boolean"},"coverage":{"oneOf":[{"type":"object","title":"SessionLawListCoverage","description":"Present only on an EMPTY page: what we hold of the session (or state) you asked about, so you can tell `nothing matches your filters` from `we have not collected this`. `status: complete` means the first: the page is charged. `partial` (the collection stopped short) and `not_held` (we hold nothing of it) mean the second: the page is NOT charged and `creditsConsumed` is 0. Omitted when the coverage cannot be read, in which case the empty page is charged as before.","required":["scope","jurisdiction","status","message"],"properties":{"scope":{"type":"string","enum":["session","jurisdiction"],"title":"Scope","description":"`session` when the request named a `session`, `jurisdiction` when it named only the state.","examples":["session","jurisdiction"],"isRequired":true,"uniqueKey":"coverage.oneOf.0.scope","typeLabel":"enum\u003cstring>"},"jurisdiction":{"type":"string","title":"Jurisdiction","description":"Lowercase two-letter code of the state, `dc` or `pr`.","examples":["ok"],"isRequired":true,"uniqueKey":"coverage.oneOf.0.jurisdiction","typeLabel":"string"},"status":{"type":"string","enum":["complete","partial","not_held"],"title":"Status","description":"`complete`: we hold every law the publisher lists for what you asked about, so an empty page means nothing matches your filters, and it is charged. `partial`: the collection stopped short, so the empty page may be a gap in our collection and not an absence of law; it is not charged when everything you asked about is partial. On a state-wide request (`scope: jurisdiction`) with some sessions complete and some partial the status is `partial`, `partialSessions` names the ones to doubt, and the page is charged, because for the complete sessions it is a true negative. `not_held`: we hold no session laws for this session or state at all; not charged.","examples":["complete","partial","not_held"],"isRequired":true,"uniqueKey":"coverage.oneOf.0.status","typeLabel":"enum\u003cstring>"},"message":{"type":"string","title":"Message","description":"One sentence saying what this empty page means and whether it was charged. Free text to show, not an enum to branch on: branch on `status`.","examples":["No law in this session matches your filters. We hold every law the publisher lists for 2025R, so this is not a gap in our collection."],"isRequired":true,"uniqueKey":"coverage.oneOf.0.message","typeLabel":"string"},"session":{"oneOf":[{"type":"object","title":"SessionLawSession","description":"The session you named, when `scope` is `session` and we hold any of it. Its counts are in the jurisdiction's `sessionLaws` block on `GET /us/statutes/coverage`.","required":["code"],"properties":{"code":{"type":"string","title":"Code","description":"Session code, `{year}{type}{ordinal}`. `type` is `R` regular, `S` special, `X` extraordinary, `F` fiscal, `V` veto, `U` unknown. A regular session has no ordinal (`2025R`); a numbered special session carries it (`2025S1`, the first special session of 2025); a lettered one carries its letter (`2025SC`, Florida's Special Session C). `year` is the year the publisher numbers the session by, which for a period spanning two years is the first (District of Columbia Council Period 25 is `2023R`). Pass it as `session` to `GET /us/session-laws/list`.","examples":["2025R","2025S1"],"isRequired":true,"uniqueKey":"coverage.oneOf.0.session.oneOf.0.code","typeLabel":"string"},"label":{"oneOf":[{"type":"string","title":"Label","description":"The session's canonical label, as the publisher names it.","example":"2025 Regular Session","uniqueKey":"coverage.oneOf.0.session.oneOf.0.label.oneOf.0","typeLabel":"string"},{"type":"null","title":"Label","description":"The session's canonical label, as the publisher names it.","example":"2025 Regular Session","uniqueKey":"coverage.oneOf.0.session.oneOf.0.label.oneOf.1","typeLabel":"null"}],"uniqueKey":"coverage.oneOf.0.session.oneOf.0.label","typeLabel":"string | null"},"type":{"oneOf":[{"type":"string","title":"Type","description":"`regular`, `special`, `extraordinary`, `fiscal`, `veto` or `unknown`.","example":"regular","uniqueKey":"coverage.oneOf.0.session.oneOf.0.type.oneOf.0","typeLabel":"string"},{"type":"null","title":"Type","description":"`regular`, `special`, `extraordinary`, `fiscal`, `veto` or `unknown`.","example":"regular","uniqueKey":"coverage.oneOf.0.session.oneOf.0.type.oneOf.1","typeLabel":"null"}],"uniqueKey":"coverage.oneOf.0.session.oneOf.0.type","typeLabel":"string | null"},"year":{"oneOf":[{"type":"integer","title":"Year","description":"The year the session convened, the same year `code` starts with.","example":2025,"uniqueKey":"coverage.oneOf.0.session.oneOf.0.year.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Year","description":"The year the session convened, the same year `code` starts with.","example":2025,"uniqueKey":"coverage.oneOf.0.session.oneOf.0.year.oneOf.1","typeLabel":"null"}],"uniqueKey":"coverage.oneOf.0.session.oneOf.0.year","typeLabel":"integer | null"}},"uniqueKey":"coverage.oneOf.0.session.oneOf.0","typeLabel":"SessionLawSession · object"},{"type":"null","description":"The session you named, when `scope` is `session` and we hold any of it. Its counts are in the jurisdiction's `sessionLaws` block on `GET /us/statutes/coverage`.","uniqueKey":"coverage.oneOf.0.session.oneOf.1","typeLabel":"null"}],"uniqueKey":"coverage.oneOf.0.session","typeLabel":"SessionLawSession · object | null"},"sessionsHeld":{"type":"integer","minimum":0,"title":"Sessionsheld","description":"How many sessions of this state we hold session laws for. 0 when `not_held`.","default":0,"examples":[1,0],"uniqueKey":"coverage.oneOf.0.sessionsHeld","typeLabel":"integer"},"partialSessions":{"items":{"type":"string","uniqueKey":"coverage.oneOf.0.partialSessions.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Partialsessions","description":"Session codes of this state whose collection is `partial`: the ones an empty page may be missing laws from. At most the 10 newest are listed, oldest first, and `message` says how many earlier ones are left out. Empty when none.","examples":[["2025R"],[]],"uniqueKey":"coverage.oneOf.0.partialSessions","typeLabel":"string[]"},"reason":{"oneOf":[{"type":"string","title":"Reason","description":"Present on `not_held`: why we hold nothing, in one plain sentence. A gap in our collection, not a statement that the state enacted no laws.","example":"We have not collected this jurisdiction's session laws yet.","uniqueKey":"coverage.oneOf.0.reason.oneOf.0","typeLabel":"string"},{"type":"null","title":"Reason","description":"Present on `not_held`: why we hold nothing, in one plain sentence. A gap in our collection, not a statement that the state enacted no laws.","example":"We have not collected this jurisdiction's session laws yet.","uniqueKey":"coverage.oneOf.0.reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"coverage.oneOf.0.reason","typeLabel":"string | null"}},"uniqueKey":"coverage.oneOf.0","typeLabel":"SessionLawListCoverage · object"},{"type":"null","description":"Present only on an EMPTY page: what we hold of the session (or state) you asked about, so you can tell `nothing matches your filters` from `we have not collected this`. `status: complete` means the first: the page is charged. `partial` (the collection stopped short) and `not_held` (we hold nothing of it) mean the second: the page is NOT charged and `creditsConsumed` is 0. Omitted when the coverage cannot be read, in which case the empty page is charged as before.","uniqueKey":"coverage.oneOf.1","typeLabel":"null"}],"uniqueKey":"coverage","typeLabel":"SessionLawListCoverage · object | null"}},"type":"object","title":"SessionLawListResponse","description":"Response for `GET /us/session-laws/list`.","uniqueKey":"","typeLabel":"SessionLawListResponse · object"},"examples":{"search":{"title":"search","value":{"results":[{"sessionLawId":"SSL_MN_2025R_G_Y2025_C10","jurisdiction":"mn","citation":"CHAPTER 10--H.F.No. 2184","citableAs":"Minn. Laws 2025, ch. 10","citationShort":"MN ch. 10 (2025)","session":{"code":"2025R","label":"2025 Regular Session","type":"regular","year":2025},"series":"general","instrumentType":"act","number":"10","billNumber":"H.F.No. 2184","numberingYear":2025,"title":"An act relating to court fees; exempting the Office of Ombudsperson for American Indian Families from court fee requirements; amending Minnesota Statutes 2024, section 357.021, subdivision 1a.","approvedDate":"2025-04-30","approvedDateDerived":false,"enactmentOutcome":"signed","isLaw":true,"textStatus":"held","charCount":4561,"estimatedBodyPages":1,"textSha256":"6c4008d050a5b85a7eaf03cd6f26ccca5160f015bbeb7bf9dceece9bd8bcd8d9","versionNo":1,"amendatoryMarkup":"preserved","markupConvention":"publisher_literal","documentKind":"session_law_print","identityConfidence":"single_source","licenseNote":"Government public: published by a government body with no restrictive terms, so the text may be reused, including commercially.","updatedAt":"2026-10-05T09:06:39.998043+00:00"}],"count":1,"hasMore":false,"processingTimeMs":204.1,"creditsConsumed":1}},"session":{"title":"session","value":{"results":[{"sessionLawId":"SSL_MN_2025R_G_Y2025_C1","jurisdiction":"mn","citation":"CHAPTER 1--S.F.No. 1552","citableAs":"Minn. Laws 2025, ch. 1","citationShort":"MN ch. 1 (2025)","session":{"code":"2025R","label":"2025 Regular Session","type":"regular","year":2025},"series":"general","instrumentType":"act","number":"1","billNumber":"S.F.No. 1552","numberingYear":2025,"title":"An act relating to agriculture; modifying financial reporting requirements for grain buyers; amending Minnesota Statutes 2024, section 223.17, subdivision 6.","approvedDate":"2025-03-17","approvedDateDerived":false,"enactmentOutcome":"signed","isLaw":true,"textStatus":"held","charCount":5470,"estimatedBodyPages":1,"textSha256":"55c7a8d08647e41f87e23fc2016881a6583911a1d5cfa8687403442e9096451b","versionNo":1,"amendatoryMarkup":"preserved","markupConvention":"publisher_literal","documentKind":"session_law_print","identityConfidence":"single_source","licenseNote":"Government public: published by a government body with no restrictive terms, so the text may be reused, including commercially.","updatedAt":"2026-10-05T09:06:39.998043+00:00"},{"sessionLawId":"SSL_MN_2025R_G_Y2025_C10","jurisdiction":"mn","citation":"CHAPTER 10--H.F.No. 2184","citableAs":"Minn. Laws 2025, ch. 10","citationShort":"MN ch. 10 (2025)","session":{"code":"2025R","label":"2025 Regular Session","type":"regular","year":2025},"series":"general","instrumentType":"act","number":"10","billNumber":"H.F.No. 2184","numberingYear":2025,"title":"An act relating to court fees; exempting the Office of Ombudsperson for American Indian Families from court fee requirements; amending Minnesota Statutes 2024, section 357.021, subdivision 1a.","approvedDate":"2025-04-30","approvedDateDerived":false,"enactmentOutcome":"signed","isLaw":true,"textStatus":"held","charCount":4561,"estimatedBodyPages":1,"textSha256":"6c4008d050a5b85a7eaf03cd6f26ccca5160f015bbeb7bf9dceece9bd8bcd8d9","versionNo":1,"amendatoryMarkup":"preserved","markupConvention":"publisher_literal","documentKind":"session_law_print","identityConfidence":"single_source","licenseNote":"Government public: published by a government body with no restrictive terms, so the text may be reused, including commercially.","updatedAt":"2026-10-05T09:06:39.998043+00:00"}],"count":2,"nextCursor":"eyJ2IjoyLCJqIjoibW4iLCJzIjoiMjAyNVIiLCJpIjoiU1NMX01OXzIwMjVSX0dfWTIwMjVfQzEwIiwicSI6IjYxMjk2NDEzOTE2OTJmOTYifQ.86d0NXnVAJD7j_3d9zoWPQ","hasMore":true,"processingTimeMs":186.4,"creditsConsumed":1}},"effectiveDate":{"title":"effectiveDate","value":{"results":[{"sessionLawId":"SSL_TX_2025R_G_Y2025_C1","jurisdiction":"tx","citation":"89th Regular Session, ch. 1","citableAs":"2025 Tex. Gen. Laws ch. 1","citationShort":"TX ch. 1 (2025)","session":{"code":"2025R","label":"89th Regular Session","type":"regular","year":2025},"series":"general","instrumentType":"act","number":"1","billNumber":"S.B. No. 14","numberingYear":2025,"title":"Relating to reforming the procedure by which state agencies adopt rules and impose regulatory requirements and the deference given to the interpretation of laws and rules by state agencies in certain judicial proceedings.","approvedDate":"2025-04-23","approvedDateDerived":false,"effectiveFirst":"2025-09-01","effectiveLast":"2025-09-01","enactmentOutcome":"signed","isLaw":true,"textStatus":"held","charCount":18449,"estimatedBodyPages":1,"textSha256":"27df48f5be5c3d8b6a13832b064710b7584cd26b1dd1de0033f085dd3249f257","versionNo":1,"amendatoryMarkup":"preserved","markupConvention":"mixed","documentKind":"enrolled_bill","identityConfidence":"single_source","licenseNote":"Government public: published by a government body with no restrictive terms, so the text may be reused, including commercially.","updatedAt":"2026-10-05T09:04:11.120118+00:00"},{"sessionLawId":"SSL_TX_2025R_G_Y2025_C10","jurisdiction":"tx","citation":"89th Regular Session, ch. 10","citableAs":"2025 Tex. Gen. Laws ch. 10","citationShort":"TX ch. 10 (2025)","session":{"code":"2025R","label":"89th Regular Session","type":"regular","year":2025},"series":"general","instrumentType":"act","number":"10","billNumber":"S.B. No. 711","numberingYear":2025,"title":"Relating to property owners' associations, including condominium unit owners' associations.","approvedDate":"2025-05-13","approvedDateDerived":false,"effectiveFirst":"2025-09-01","effectiveLast":"2025-09-01","enactmentOutcome":"signed","isLaw":true,"textStatus":"held","charCount":10764,"estimatedBodyPages":1,"textSha256":"8d82fb97105d63cd50ec09865c1591cbaa8d3996f813951bba4f9a52bdb8e92b","versionNo":1,"amendatoryMarkup":"preserved","markupConvention":"mixed","documentKind":"enrolled_bill","identityConfidence":"single_source","licenseNote":"Government public: published by a government body with no restrictive terms, so the text may be reused, including commercially.","updatedAt":"2026-10-05T09:04:11.120118+00:00"}],"count":2,"nextCursor":"eyJ2IjoyLCJqIjoidHgiLCJzIjoiMjAyNVIiLCJpIjoiU1NMX1RYXzIwMjVSX0dfWTIwMjVfQzEwIiwicSI6IjMzYmM2NWQ5MWU2ZjAyZjUifQ.V2XakPeIVCCaxSqKPBCbFg","hasMore":true,"processingTimeMs":231.9,"creditsConsumed":1}},"emptyPartialSession":{"title":"emptyPartialSession","value":{"results":[],"count":0,"hasMore":false,"coverage":{"scope":"session","jurisdiction":"ok","status":"partial","session":{"code":"2025R","label":"Oklahoma Session Laws - 2025","type":"regular","year":2025},"sessionsHeld":1,"partialSessions":["2025R"],"message":"No law in session 2025R matches your filters, but we hold only part of this session, so the law you want may exist. This page was not charged."},"processingTimeMs":47.2,"creditsConsumed":0}},"emptyCompleteSession":{"title":"emptyCompleteSession","value":{"results":[],"count":0,"hasMore":false,"coverage":{"scope":"session","jurisdiction":"mn","status":"complete","session":{"code":"2025R","label":"2025 Regular Session","type":"regular","year":2025},"sessionsHeld":2,"partialSessions":[],"message":"No law in session 2025R matches your filters. We hold every law the publisher lists for it, so this is not a gap in our collection."},"processingTimeMs":51.8,"creditsConsumed":1}},"emptyNotHeld":{"title":"emptyNotHeld","value":{"results":[],"count":0,"hasMore":false,"coverage":{"scope":"jurisdiction","jurisdiction":"in","status":"not_held","sessionsHeld":0,"partialSessions":[],"reason":"We have not collected this jurisdiction's session laws yet.","message":"We have not collected this jurisdiction's session laws yet. This page was not charged."},"processingTimeMs":38.6,"creditsConsumed":0}}},"exampleType":"examples"}},"headers":{"X-RateLimit-Limit":{"description":"Requests allowed in the current per-minute window.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current per-minute window.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp at which the per-minute window resets.","schema":{"type":"integer"}},"X-RateLimit-Limit-Day":{"description":"Requests allowed per day (the slow-drip backstop).","schema":{"type":"integer"}},"X-RateLimit-Remaining-Day":{"description":"Requests left in the daily window.","schema":{"type":"integer"}},"X-Request-ID":{"description":"Correlation id of this request. Quote it when contacting support.","schema":{"type":"string"}}},"exampleType":"examples"},"d92aaf2b-01c8-4a23-9510-994bc2993fd7":{"description":"Missing, invalid or revoked API key. Not charged.","content":{"application/json":{"example":{"detail":"Invalid or expired API key"},"schema":{"properties":{"detail":{"type":"string","title":"Detail","description":"Human-readable reason, safe to surface to an end user. Branch on the HTTP status rather than on this string: the wording is not part of the contract and may be reworded, but 401 (bad key), 402 (out of credits), 403 (missing scope), 404 (no such resource) and 429 (rate limited) are stable.","examples":["Insufficient API credits."],"isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"errors":{"oneOf":[{"type":"array","items":{"properties":{"loc":{"items":{"oneOf":[{"type":"string","uniqueKey":"errors.oneOf.0.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"errors.oneOf.0.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"errors.oneOf.0.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"type":"array","title":"Loc","description":"Where the bad value is: `body`, `query` or `path`, then the parameter name exactly as you send it (camelCase), then list indexes. A bare `[\"body\"]` means the body as a whole was not a JSON object.","examples":[["body","corpusType"]],"isRequired":true,"uniqueKey":"errors.oneOf.0.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"type":"string","title":"Msg","description":"What is wrong with the value, in plain English.","examples":["Input should be 'USC', 'CFR' or 'STATE'"],"isRequired":true,"uniqueKey":"errors.oneOf.0.items.[INDEX].msg","typeLabel":"string"},"type":{"type":"string","title":"Type","description":"Machine-readable error kind, e.g. `missing`, `literal_error`, `json_invalid`.","examples":["literal_error"],"isRequired":true,"uniqueKey":"errors.oneOf.0.items.[INDEX].type","typeLabel":"string"}},"type":"object","required":["loc","msg","type"],"title":"ApiFieldError","description":"One rejected field in a 422 response.","uniqueKey":"errors.oneOf.0.items.[INDEX]","typeLabel":"ApiFieldError · object"},"title":"Errors","description":"Present on 422 only: every field that failed validation.","uniqueKey":"errors.oneOf.0","typeLabel":"ApiFieldError · object[]"},{"type":"null","title":"Errors","description":"Present on 422 only: every field that failed validation.","uniqueKey":"errors.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors","typeLabel":"ApiFieldError · object[] | null"},"code":{"oneOf":[{"type":"string","title":"Code","description":"Stable machine code for the failure. Branch on this, not on `detail`. The set is open: tolerate values you do not know. Known values: authentication_required, invalid_api_key, api_key_expired, permission_denied, insufficient_scope, insufficient_credits, rate_limited, daily_cap_exceeded, validation_error, invalid_query, invalid_citation_input, section_not_found, resource_not_found, idempotency_key_reused, idempotency_in_progress, idempotency_replay_unavailable, upstream_timeout, service_unavailable, internal_error, conflict.","x-known-values":["authentication_required","invalid_api_key","api_key_expired","permission_denied","insufficient_scope","insufficient_credits","rate_limited","daily_cap_exceeded","validation_error","invalid_query","invalid_citation_input","section_not_found","resource_not_found","idempotency_key_reused","idempotency_in_progress","idempotency_replay_unavailable","upstream_timeout","service_unavailable","internal_error","conflict"],"example":"insufficient_credits","uniqueKey":"code.oneOf.0","typeLabel":"string"},{"type":"null","title":"Code","description":"Stable machine code for the failure. Branch on this, not on `detail`. The set is open: tolerate values you do not know. Known values: authentication_required, invalid_api_key, api_key_expired, permission_denied, insufficient_scope, insufficient_credits, rate_limited, daily_cap_exceeded, validation_error, invalid_query, invalid_citation_input, section_not_found, resource_not_found, idempotency_key_reused, idempotency_in_progress, idempotency_replay_unavailable, upstream_timeout, service_unavailable, internal_error, conflict.","x-known-values":["authentication_required","invalid_api_key","api_key_expired","permission_denied","insufficient_scope","insufficient_credits","rate_limited","daily_cap_exceeded","validation_error","invalid_query","invalid_citation_input","section_not_found","resource_not_found","idempotency_key_reused","idempotency_in_progress","idempotency_replay_unavailable","upstream_timeout","service_unavailable","internal_error","conflict"],"example":"insufficient_credits","uniqueKey":"code.oneOf.1","typeLabel":"null"}],"uniqueKey":"code","typeLabel":"string | null"},"type":{"oneOf":[{"type":"string","title":"Type","description":"URL naming the error kind, `https://www.vaquill.ai/docs/errors/{code}`.","example":"https://www.vaquill.ai/docs/errors/insufficient_credits","uniqueKey":"type.oneOf.0","typeLabel":"string"},{"type":"null","title":"Type","description":"URL naming the error kind, `https://www.vaquill.ai/docs/errors/{code}`.","example":"https://www.vaquill.ai/docs/errors/insufficient_credits","uniqueKey":"type.oneOf.1","typeLabel":"null"}],"uniqueKey":"type","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","title":"Title","description":"Short fixed English title for `code`.","example":"Insufficient credits","uniqueKey":"title.oneOf.0","typeLabel":"string"},{"type":"null","title":"Title","description":"Short fixed English title for `code`.","example":"Insufficient credits","uniqueKey":"title.oneOf.1","typeLabel":"null"}],"uniqueKey":"title","typeLabel":"string | null"},"status":{"oneOf":[{"type":"integer","title":"Status","description":"Echo of the HTTP status code.","example":402,"uniqueKey":"status.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Status","description":"Echo of the HTTP status code.","example":402,"uniqueKey":"status.oneOf.1","typeLabel":"null"}],"uniqueKey":"status","typeLabel":"integer | null"},"requestId":{"oneOf":[{"type":"string","title":"Requestid","description":"Equals the `X-Request-ID` response header. Quote it to support.","example":"8d32789e-7b27-44f7-9523-424596e7a929","uniqueKey":"requestId.oneOf.0","typeLabel":"string"},{"type":"null","title":"Requestid","description":"Equals the `X-Request-ID` response header. Quote it to support.","example":"8d32789e-7b27-44f7-9523-424596e7a929","uniqueKey":"requestId.oneOf.1","typeLabel":"null"}],"uniqueKey":"requestId","typeLabel":"string | null"},"retryable":{"oneOf":[{"type":"boolean","title":"Retryable","description":"True only when repeating the same request is safe and may succeed.","example":false,"uniqueKey":"retryable.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Retryable","description":"True only when repeating the same request is safe and may succeed.","example":false,"uniqueKey":"retryable.oneOf.1","typeLabel":"null"}],"uniqueKey":"retryable","typeLabel":"boolean | null"},"retryAfterSeconds":{"oneOf":[{"type":"integer","title":"Retryafterseconds","description":"On 429 and 503 when `Retry-After` is set: the same value in seconds.","example":30,"uniqueKey":"retryAfterSeconds.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Retryafterseconds","description":"On 429 and 503 when `Retry-After` is set: the same value in seconds.","example":30,"uniqueKey":"retryAfterSeconds.oneOf.1","typeLabel":"null"}],"uniqueKey":"retryAfterSeconds","typeLabel":"integer | null"},"actId":{"oneOf":[{"type":"string","title":"Actid","description":"Section routes only, on a miss: the identifier that matched nothing.","example":"USC_99_9999","uniqueKey":"actId.oneOf.0","typeLabel":"string"},{"type":"null","title":"Actid","description":"Section routes only, on a miss: the identifier that matched nothing.","example":"USC_99_9999","uniqueKey":"actId.oneOf.1","typeLabel":"null"}],"uniqueKey":"actId","typeLabel":"string | null"},"reason":{"oneOf":[{"type":"string","title":"Reason","description":"Section routes only, on a miss: why nothing matched, for example `unsupported_jurisdiction` or `not_in_registry`. The set is open.","example":"not_in_registry","uniqueKey":"reason.oneOf.0","typeLabel":"string"},{"type":"null","title":"Reason","description":"Section routes only, on a miss: why nothing matched, for example `unsupported_jurisdiction` or `not_in_registry`. The set is open.","example":"not_in_registry","uniqueKey":"reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"reason","typeLabel":"string | null"},"didYouMean":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"didYouMean.oneOf.0.items.[INDEX]","typeLabel":"string"},"title":"Didyoumean","description":"Section routes only, on a miss: identifiers worth trying instead.","uniqueKey":"didYouMean.oneOf.0","typeLabel":"string[]"},{"type":"null","title":"Didyoumean","description":"Section routes only, on a miss: identifiers worth trying instead.","uniqueKey":"didYouMean.oneOf.1","typeLabel":"null"}],"uniqueKey":"didYouMean","typeLabel":"string[] | null"}},"type":"object","required":["detail"],"title":"ApiDetailError","description":"Error envelope the API actually returns.\n\nEvery error (400/401/402/403/404/405/422/429/5xx) carries a `detail`\nstring, e.g. `{\"detail\": \"Insufficient API credits.\"}`, on every mount of\nthe API. A 422 adds `errors`, one entry per rejected field. Some 404s add\nendpoint-specific diagnosis beside `detail` (the statutes section routes\nadd `actId`, `reason` and `didYouMean`); treat unknown keys as optional.","uniqueKey":"","typeLabel":"ApiDetailError · object"},"examples":{"Example":{"title":"Example","value":{"detail":"Invalid or expired API key"}}},"exampleType":"examples"}},"headers":{"X-RateLimit-Limit":{"description":"Requests allowed in the current per-minute window.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current per-minute window.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp at which the per-minute window resets.","schema":{"type":"integer"}},"X-RateLimit-Limit-Day":{"description":"Requests allowed per day (the slow-drip backstop).","schema":{"type":"integer"}},"X-RateLimit-Remaining-Day":{"description":"Requests left in the daily window.","schema":{"type":"integer"}},"X-Request-ID":{"description":"Correlation id of this request. Quote it when contacting support.","schema":{"type":"string"}}},"exampleType":"examples"},"2f880e04-8914-4190-8cb2-2e0547038634":{"description":"Insufficient credits for this call. Nothing was done and nothing was charged. Read your balance, free, at `GET /credits/balance`.","content":{"application/json":{"example":{"detail":"Insufficient credits"},"schema":{"properties":{"detail":{"type":"string","title":"Detail","description":"Human-readable reason, safe to surface to an end user. Branch on the HTTP status rather than on this string: the wording is not part of the contract and may be reworded, but 401 (bad key), 402 (out of credits), 403 (missing scope), 404 (no such resource) and 429 (rate limited) are stable.","examples":["Insufficient API credits."],"isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"errors":{"oneOf":[{"type":"array","items":{"properties":{"loc":{"items":{"oneOf":[{"type":"string","uniqueKey":"errors.oneOf.0.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"errors.oneOf.0.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"errors.oneOf.0.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"type":"array","title":"Loc","description":"Where the bad value is: `body`, `query` or `path`, then the parameter name exactly as you send it (camelCase), then list indexes. A bare `[\"body\"]` means the body as a whole was not a JSON object.","examples":[["body","corpusType"]],"isRequired":true,"uniqueKey":"errors.oneOf.0.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"type":"string","title":"Msg","description":"What is wrong with the value, in plain English.","examples":["Input should be 'USC', 'CFR' or 'STATE'"],"isRequired":true,"uniqueKey":"errors.oneOf.0.items.[INDEX].msg","typeLabel":"string"},"type":{"type":"string","title":"Type","description":"Machine-readable error kind, e.g. `missing`, `literal_error`, `json_invalid`.","examples":["literal_error"],"isRequired":true,"uniqueKey":"errors.oneOf.0.items.[INDEX].type","typeLabel":"string"}},"type":"object","required":["loc","msg","type"],"title":"ApiFieldError","description":"One rejected field in a 422 response.","uniqueKey":"errors.oneOf.0.items.[INDEX]","typeLabel":"ApiFieldError · object"},"title":"Errors","description":"Present on 422 only: every field that failed validation.","uniqueKey":"errors.oneOf.0","typeLabel":"ApiFieldError · object[]"},{"type":"null","title":"Errors","description":"Present on 422 only: every field that failed validation.","uniqueKey":"errors.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors","typeLabel":"ApiFieldError · object[] | null"},"code":{"oneOf":[{"type":"string","title":"Code","description":"Stable machine code for the failure. Branch on this, not on `detail`. The set is open: tolerate values you do not know. Known values: authentication_required, invalid_api_key, api_key_expired, permission_denied, insufficient_scope, insufficient_credits, rate_limited, daily_cap_exceeded, validation_error, invalid_query, invalid_citation_input, section_not_found, resource_not_found, idempotency_key_reused, idempotency_in_progress, idempotency_replay_unavailable, upstream_timeout, service_unavailable, internal_error, conflict.","x-known-values":["authentication_required","invalid_api_key","api_key_expired","permission_denied","insufficient_scope","insufficient_credits","rate_limited","daily_cap_exceeded","validation_error","invalid_query","invalid_citation_input","section_not_found","resource_not_found","idempotency_key_reused","idempotency_in_progress","idempotency_replay_unavailable","upstream_timeout","service_unavailable","internal_error","conflict"],"example":"insufficient_credits","uniqueKey":"code.oneOf.0","typeLabel":"string"},{"type":"null","title":"Code","description":"Stable machine code for the failure. Branch on this, not on `detail`. The set is open: tolerate values you do not know. Known values: authentication_required, invalid_api_key, api_key_expired, permission_denied, insufficient_scope, insufficient_credits, rate_limited, daily_cap_exceeded, validation_error, invalid_query, invalid_citation_input, section_not_found, resource_not_found, idempotency_key_reused, idempotency_in_progress, idempotency_replay_unavailable, upstream_timeout, service_unavailable, internal_error, conflict.","x-known-values":["authentication_required","invalid_api_key","api_key_expired","permission_denied","insufficient_scope","insufficient_credits","rate_limited","daily_cap_exceeded","validation_error","invalid_query","invalid_citation_input","section_not_found","resource_not_found","idempotency_key_reused","idempotency_in_progress","idempotency_replay_unavailable","upstream_timeout","service_unavailable","internal_error","conflict"],"example":"insufficient_credits","uniqueKey":"code.oneOf.1","typeLabel":"null"}],"uniqueKey":"code","typeLabel":"string | null"},"type":{"oneOf":[{"type":"string","title":"Type","description":"URL naming the error kind, `https://www.vaquill.ai/docs/errors/{code}`.","example":"https://www.vaquill.ai/docs/errors/insufficient_credits","uniqueKey":"type.oneOf.0","typeLabel":"string"},{"type":"null","title":"Type","description":"URL naming the error kind, `https://www.vaquill.ai/docs/errors/{code}`.","example":"https://www.vaquill.ai/docs/errors/insufficient_credits","uniqueKey":"type.oneOf.1","typeLabel":"null"}],"uniqueKey":"type","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","title":"Title","description":"Short fixed English title for `code`.","example":"Insufficient credits","uniqueKey":"title.oneOf.0","typeLabel":"string"},{"type":"null","title":"Title","description":"Short fixed English title for `code`.","example":"Insufficient credits","uniqueKey":"title.oneOf.1","typeLabel":"null"}],"uniqueKey":"title","typeLabel":"string | null"},"status":{"oneOf":[{"type":"integer","title":"Status","description":"Echo of the HTTP status code.","example":402,"uniqueKey":"status.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Status","description":"Echo of the HTTP status code.","example":402,"uniqueKey":"status.oneOf.1","typeLabel":"null"}],"uniqueKey":"status","typeLabel":"integer | null"},"requestId":{"oneOf":[{"type":"string","title":"Requestid","description":"Equals the `X-Request-ID` response header. Quote it to support.","example":"8d32789e-7b27-44f7-9523-424596e7a929","uniqueKey":"requestId.oneOf.0","typeLabel":"string"},{"type":"null","title":"Requestid","description":"Equals the `X-Request-ID` response header. Quote it to support.","example":"8d32789e-7b27-44f7-9523-424596e7a929","uniqueKey":"requestId.oneOf.1","typeLabel":"null"}],"uniqueKey":"requestId","typeLabel":"string | null"},"retryable":{"oneOf":[{"type":"boolean","title":"Retryable","description":"True only when repeating the same request is safe and may succeed.","example":false,"uniqueKey":"retryable.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Retryable","description":"True only when repeating the same request is safe and may succeed.","example":false,"uniqueKey":"retryable.oneOf.1","typeLabel":"null"}],"uniqueKey":"retryable","typeLabel":"boolean | null"},"retryAfterSeconds":{"oneOf":[{"type":"integer","title":"Retryafterseconds","description":"On 429 and 503 when `Retry-After` is set: the same value in seconds.","example":30,"uniqueKey":"retryAfterSeconds.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Retryafterseconds","description":"On 429 and 503 when `Retry-After` is set: the same value in seconds.","example":30,"uniqueKey":"retryAfterSeconds.oneOf.1","typeLabel":"null"}],"uniqueKey":"retryAfterSeconds","typeLabel":"integer | null"},"actId":{"oneOf":[{"type":"string","title":"Actid","description":"Section routes only, on a miss: the identifier that matched nothing.","example":"USC_99_9999","uniqueKey":"actId.oneOf.0","typeLabel":"string"},{"type":"null","title":"Actid","description":"Section routes only, on a miss: the identifier that matched nothing.","example":"USC_99_9999","uniqueKey":"actId.oneOf.1","typeLabel":"null"}],"uniqueKey":"actId","typeLabel":"string | null"},"reason":{"oneOf":[{"type":"string","title":"Reason","description":"Section routes only, on a miss: why nothing matched, for example `unsupported_jurisdiction` or `not_in_registry`. The set is open.","example":"not_in_registry","uniqueKey":"reason.oneOf.0","typeLabel":"string"},{"type":"null","title":"Reason","description":"Section routes only, on a miss: why nothing matched, for example `unsupported_jurisdiction` or `not_in_registry`. The set is open.","example":"not_in_registry","uniqueKey":"reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"reason","typeLabel":"string | null"},"didYouMean":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"didYouMean.oneOf.0.items.[INDEX]","typeLabel":"string"},"title":"Didyoumean","description":"Section routes only, on a miss: identifiers worth trying instead.","uniqueKey":"didYouMean.oneOf.0","typeLabel":"string[]"},{"type":"null","title":"Didyoumean","description":"Section routes only, on a miss: identifiers worth trying instead.","uniqueKey":"didYouMean.oneOf.1","typeLabel":"null"}],"uniqueKey":"didYouMean","typeLabel":"string[] | null"}},"type":"object","required":["detail"],"title":"ApiDetailError","description":"Error envelope the API actually returns.\n\nEvery error (400/401/402/403/404/405/422/429/5xx) carries a `detail`\nstring, e.g. `{\"detail\": \"Insufficient API credits.\"}`, on every mount of\nthe API. A 422 adds `errors`, one entry per rejected field. Some 404s add\nendpoint-specific diagnosis beside `detail` (the statutes section routes\nadd `actId`, `reason` and `didYouMean`); treat unknown keys as optional.","uniqueKey":"","typeLabel":"ApiDetailError · object"},"examples":{"Example":{"title":"Example","value":{"detail":"Insufficient credits"}}},"exampleType":"examples"}},"headers":{"X-RateLimit-Limit":{"description":"Requests allowed in the current per-minute window.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current per-minute window.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp at which the per-minute window resets.","schema":{"type":"integer"}},"X-RateLimit-Limit-Day":{"description":"Requests allowed per day (the slow-drip backstop).","schema":{"type":"integer"}},"X-RateLimit-Remaining-Day":{"description":"Requests left in the daily window.","schema":{"type":"integer"}},"X-Request-ID":{"description":"Correlation id of this request. Quote it when contacting support.","schema":{"type":"string"}}},"exampleType":"examples"},"792ae10f-6032-45c0-8310-1d99bdae770a":{"description":"The API key lacks the `research:read` scope. Not charged.","content":{"application/json":{"example":{"detail":"Insufficient permissions for this operation"},"schema":{"properties":{"detail":{"type":"string","title":"Detail","description":"Human-readable reason, safe to surface to an end user. Branch on the HTTP status rather than on this string: the wording is not part of the contract and may be reworded, but 401 (bad key), 402 (out of credits), 403 (missing scope), 404 (no such resource) and 429 (rate limited) are stable.","examples":["Insufficient API credits."],"isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"errors":{"oneOf":[{"type":"array","items":{"properties":{"loc":{"items":{"oneOf":[{"type":"string","uniqueKey":"errors.oneOf.0.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"errors.oneOf.0.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"errors.oneOf.0.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"type":"array","title":"Loc","description":"Where the bad value is: `body`, `query` or `path`, then the parameter name exactly as you send it (camelCase), then list indexes. A bare `[\"body\"]` means the body as a whole was not a JSON object.","examples":[["body","corpusType"]],"isRequired":true,"uniqueKey":"errors.oneOf.0.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"type":"string","title":"Msg","description":"What is wrong with the value, in plain English.","examples":["Input should be 'USC', 'CFR' or 'STATE'"],"isRequired":true,"uniqueKey":"errors.oneOf.0.items.[INDEX].msg","typeLabel":"string"},"type":{"type":"string","title":"Type","description":"Machine-readable error kind, e.g. `missing`, `literal_error`, `json_invalid`.","examples":["literal_error"],"isRequired":true,"uniqueKey":"errors.oneOf.0.items.[INDEX].type","typeLabel":"string"}},"type":"object","required":["loc","msg","type"],"title":"ApiFieldError","description":"One rejected field in a 422 response.","uniqueKey":"errors.oneOf.0.items.[INDEX]","typeLabel":"ApiFieldError · object"},"title":"Errors","description":"Present on 422 only: every field that failed validation.","uniqueKey":"errors.oneOf.0","typeLabel":"ApiFieldError · object[]"},{"type":"null","title":"Errors","description":"Present on 422 only: every field that failed validation.","uniqueKey":"errors.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors","typeLabel":"ApiFieldError · object[] | null"},"code":{"oneOf":[{"type":"string","title":"Code","description":"Stable machine code for the failure. Branch on this, not on `detail`. The set is open: tolerate values you do not know. Known values: authentication_required, invalid_api_key, api_key_expired, permission_denied, insufficient_scope, insufficient_credits, rate_limited, daily_cap_exceeded, validation_error, invalid_query, invalid_citation_input, section_not_found, resource_not_found, idempotency_key_reused, idempotency_in_progress, idempotency_replay_unavailable, upstream_timeout, service_unavailable, internal_error, conflict.","x-known-values":["authentication_required","invalid_api_key","api_key_expired","permission_denied","insufficient_scope","insufficient_credits","rate_limited","daily_cap_exceeded","validation_error","invalid_query","invalid_citation_input","section_not_found","resource_not_found","idempotency_key_reused","idempotency_in_progress","idempotency_replay_unavailable","upstream_timeout","service_unavailable","internal_error","conflict"],"example":"insufficient_credits","uniqueKey":"code.oneOf.0","typeLabel":"string"},{"type":"null","title":"Code","description":"Stable machine code for the failure. Branch on this, not on `detail`. The set is open: tolerate values you do not know. Known values: authentication_required, invalid_api_key, api_key_expired, permission_denied, insufficient_scope, insufficient_credits, rate_limited, daily_cap_exceeded, validation_error, invalid_query, invalid_citation_input, section_not_found, resource_not_found, idempotency_key_reused, idempotency_in_progress, idempotency_replay_unavailable, upstream_timeout, service_unavailable, internal_error, conflict.","x-known-values":["authentication_required","invalid_api_key","api_key_expired","permission_denied","insufficient_scope","insufficient_credits","rate_limited","daily_cap_exceeded","validation_error","invalid_query","invalid_citation_input","section_not_found","resource_not_found","idempotency_key_reused","idempotency_in_progress","idempotency_replay_unavailable","upstream_timeout","service_unavailable","internal_error","conflict"],"example":"insufficient_credits","uniqueKey":"code.oneOf.1","typeLabel":"null"}],"uniqueKey":"code","typeLabel":"string | null"},"type":{"oneOf":[{"type":"string","title":"Type","description":"URL naming the error kind, `https://www.vaquill.ai/docs/errors/{code}`.","example":"https://www.vaquill.ai/docs/errors/insufficient_credits","uniqueKey":"type.oneOf.0","typeLabel":"string"},{"type":"null","title":"Type","description":"URL naming the error kind, `https://www.vaquill.ai/docs/errors/{code}`.","example":"https://www.vaquill.ai/docs/errors/insufficient_credits","uniqueKey":"type.oneOf.1","typeLabel":"null"}],"uniqueKey":"type","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","title":"Title","description":"Short fixed English title for `code`.","example":"Insufficient credits","uniqueKey":"title.oneOf.0","typeLabel":"string"},{"type":"null","title":"Title","description":"Short fixed English title for `code`.","example":"Insufficient credits","uniqueKey":"title.oneOf.1","typeLabel":"null"}],"uniqueKey":"title","typeLabel":"string | null"},"status":{"oneOf":[{"type":"integer","title":"Status","description":"Echo of the HTTP status code.","example":402,"uniqueKey":"status.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Status","description":"Echo of the HTTP status code.","example":402,"uniqueKey":"status.oneOf.1","typeLabel":"null"}],"uniqueKey":"status","typeLabel":"integer | null"},"requestId":{"oneOf":[{"type":"string","title":"Requestid","description":"Equals the `X-Request-ID` response header. Quote it to support.","example":"8d32789e-7b27-44f7-9523-424596e7a929","uniqueKey":"requestId.oneOf.0","typeLabel":"string"},{"type":"null","title":"Requestid","description":"Equals the `X-Request-ID` response header. Quote it to support.","example":"8d32789e-7b27-44f7-9523-424596e7a929","uniqueKey":"requestId.oneOf.1","typeLabel":"null"}],"uniqueKey":"requestId","typeLabel":"string | null"},"retryable":{"oneOf":[{"type":"boolean","title":"Retryable","description":"True only when repeating the same request is safe and may succeed.","example":false,"uniqueKey":"retryable.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Retryable","description":"True only when repeating the same request is safe and may succeed.","example":false,"uniqueKey":"retryable.oneOf.1","typeLabel":"null"}],"uniqueKey":"retryable","typeLabel":"boolean | null"},"retryAfterSeconds":{"oneOf":[{"type":"integer","title":"Retryafterseconds","description":"On 429 and 503 when `Retry-After` is set: the same value in seconds.","example":30,"uniqueKey":"retryAfterSeconds.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Retryafterseconds","description":"On 429 and 503 when `Retry-After` is set: the same value in seconds.","example":30,"uniqueKey":"retryAfterSeconds.oneOf.1","typeLabel":"null"}],"uniqueKey":"retryAfterSeconds","typeLabel":"integer | null"},"actId":{"oneOf":[{"type":"string","title":"Actid","description":"Section routes only, on a miss: the identifier that matched nothing.","example":"USC_99_9999","uniqueKey":"actId.oneOf.0","typeLabel":"string"},{"type":"null","title":"Actid","description":"Section routes only, on a miss: the identifier that matched nothing.","example":"USC_99_9999","uniqueKey":"actId.oneOf.1","typeLabel":"null"}],"uniqueKey":"actId","typeLabel":"string | null"},"reason":{"oneOf":[{"type":"string","title":"Reason","description":"Section routes only, on a miss: why nothing matched, for example `unsupported_jurisdiction` or `not_in_registry`. The set is open.","example":"not_in_registry","uniqueKey":"reason.oneOf.0","typeLabel":"string"},{"type":"null","title":"Reason","description":"Section routes only, on a miss: why nothing matched, for example `unsupported_jurisdiction` or `not_in_registry`. The set is open.","example":"not_in_registry","uniqueKey":"reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"reason","typeLabel":"string | null"},"didYouMean":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"didYouMean.oneOf.0.items.[INDEX]","typeLabel":"string"},"title":"Didyoumean","description":"Section routes only, on a miss: identifiers worth trying instead.","uniqueKey":"didYouMean.oneOf.0","typeLabel":"string[]"},{"type":"null","title":"Didyoumean","description":"Section routes only, on a miss: identifiers worth trying instead.","uniqueKey":"didYouMean.oneOf.1","typeLabel":"null"}],"uniqueKey":"didYouMean","typeLabel":"string[] | null"}},"type":"object","required":["detail"],"title":"ApiDetailError","description":"Error envelope the API actually returns.\n\nEvery error (400/401/402/403/404/405/422/429/5xx) carries a `detail`\nstring, e.g. `{\"detail\": \"Insufficient API credits.\"}`, on every mount of\nthe API. A 422 adds `errors`, one entry per rejected field. Some 404s add\nendpoint-specific diagnosis beside `detail` (the statutes section routes\nadd `actId`, `reason` and `didYouMean`); treat unknown keys as optional.","uniqueKey":"","typeLabel":"ApiDetailError · object"},"examples":{"Example":{"title":"Example","value":{"detail":"Insufficient permissions for this operation"}}},"exampleType":"examples"}},"headers":{"X-RateLimit-Limit":{"description":"Requests allowed in the current per-minute window.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current per-minute window.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp at which the per-minute window resets.","schema":{"type":"integer"}},"X-RateLimit-Limit-Day":{"description":"Requests allowed per day (the slow-drip backstop).","schema":{"type":"integer"}},"X-RateLimit-Remaining-Day":{"description":"Requests left in the daily window.","schema":{"type":"integer"}},"X-Request-ID":{"description":"Correlation id of this request. Quote it when contacting support.","schema":{"type":"string"}}},"exampleType":"examples"},"30de2c69-bd70-41ad-9623-2cfe648ade23":{"description":"Idempotency conflict. `idempotency_in_progress`: the original request with this key is still running (retry after `Retry-After`). `idempotency_replay_unavailable`: it completed but its response was too large to replay; nothing is charged again, so check the credit balance instead of retrying.","content":{"application/json":{"schema":{"properties":{"detail":{"type":"string","title":"Detail","description":"Human-readable reason, safe to surface to an end user. Branch on the HTTP status rather than on this string: the wording is not part of the contract and may be reworded, but 401 (bad key), 402 (out of credits), 403 (missing scope), 404 (no such resource) and 429 (rate limited) are stable.","examples":["Insufficient API credits."],"isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"errors":{"oneOf":[{"type":"array","items":{"properties":{"loc":{"items":{"oneOf":[{"type":"string","uniqueKey":"errors.oneOf.0.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"errors.oneOf.0.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"errors.oneOf.0.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"type":"array","title":"Loc","description":"Where the bad value is: `body`, `query` or `path`, then the parameter name exactly as you send it (camelCase), then list indexes. A bare `[\"body\"]` means the body as a whole was not a JSON object.","examples":[["body","corpusType"]],"isRequired":true,"uniqueKey":"errors.oneOf.0.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"type":"string","title":"Msg","description":"What is wrong with the value, in plain English.","examples":["Input should be 'USC', 'CFR' or 'STATE'"],"isRequired":true,"uniqueKey":"errors.oneOf.0.items.[INDEX].msg","typeLabel":"string"},"type":{"type":"string","title":"Type","description":"Machine-readable error kind, e.g. `missing`, `literal_error`, `json_invalid`.","examples":["literal_error"],"isRequired":true,"uniqueKey":"errors.oneOf.0.items.[INDEX].type","typeLabel":"string"}},"type":"object","required":["loc","msg","type"],"title":"ApiFieldError","description":"One rejected field in a 422 response.","uniqueKey":"errors.oneOf.0.items.[INDEX]","typeLabel":"ApiFieldError · object"},"title":"Errors","description":"Present on 422 only: every field that failed validation.","uniqueKey":"errors.oneOf.0","typeLabel":"ApiFieldError · object[]"},{"type":"null","title":"Errors","description":"Present on 422 only: every field that failed validation.","uniqueKey":"errors.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors","typeLabel":"ApiFieldError · object[] | null"},"code":{"oneOf":[{"type":"string","title":"Code","description":"Stable machine code for the failure. Branch on this, not on `detail`. The set is open: tolerate values you do not know. Known values: authentication_required, invalid_api_key, api_key_expired, permission_denied, insufficient_scope, insufficient_credits, rate_limited, daily_cap_exceeded, validation_error, invalid_query, invalid_citation_input, section_not_found, resource_not_found, idempotency_key_reused, idempotency_in_progress, idempotency_replay_unavailable, upstream_timeout, service_unavailable, internal_error, conflict.","x-known-values":["authentication_required","invalid_api_key","api_key_expired","permission_denied","insufficient_scope","insufficient_credits","rate_limited","daily_cap_exceeded","validation_error","invalid_query","invalid_citation_input","section_not_found","resource_not_found","idempotency_key_reused","idempotency_in_progress","idempotency_replay_unavailable","upstream_timeout","service_unavailable","internal_error","conflict"],"example":"insufficient_credits","uniqueKey":"code.oneOf.0","typeLabel":"string"},{"type":"null","title":"Code","description":"Stable machine code for the failure. Branch on this, not on `detail`. The set is open: tolerate values you do not know. Known values: authentication_required, invalid_api_key, api_key_expired, permission_denied, insufficient_scope, insufficient_credits, rate_limited, daily_cap_exceeded, validation_error, invalid_query, invalid_citation_input, section_not_found, resource_not_found, idempotency_key_reused, idempotency_in_progress, idempotency_replay_unavailable, upstream_timeout, service_unavailable, internal_error, conflict.","x-known-values":["authentication_required","invalid_api_key","api_key_expired","permission_denied","insufficient_scope","insufficient_credits","rate_limited","daily_cap_exceeded","validation_error","invalid_query","invalid_citation_input","section_not_found","resource_not_found","idempotency_key_reused","idempotency_in_progress","idempotency_replay_unavailable","upstream_timeout","service_unavailable","internal_error","conflict"],"example":"insufficient_credits","uniqueKey":"code.oneOf.1","typeLabel":"null"}],"uniqueKey":"code","typeLabel":"string | null"},"type":{"oneOf":[{"type":"string","title":"Type","description":"URL naming the error kind, `https://www.vaquill.ai/docs/errors/{code}`.","example":"https://www.vaquill.ai/docs/errors/insufficient_credits","uniqueKey":"type.oneOf.0","typeLabel":"string"},{"type":"null","title":"Type","description":"URL naming the error kind, `https://www.vaquill.ai/docs/errors/{code}`.","example":"https://www.vaquill.ai/docs/errors/insufficient_credits","uniqueKey":"type.oneOf.1","typeLabel":"null"}],"uniqueKey":"type","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","title":"Title","description":"Short fixed English title for `code`.","example":"Insufficient credits","uniqueKey":"title.oneOf.0","typeLabel":"string"},{"type":"null","title":"Title","description":"Short fixed English title for `code`.","example":"Insufficient credits","uniqueKey":"title.oneOf.1","typeLabel":"null"}],"uniqueKey":"title","typeLabel":"string | null"},"status":{"oneOf":[{"type":"integer","title":"Status","description":"Echo of the HTTP status code.","example":402,"uniqueKey":"status.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Status","description":"Echo of the HTTP status code.","example":402,"uniqueKey":"status.oneOf.1","typeLabel":"null"}],"uniqueKey":"status","typeLabel":"integer | null"},"requestId":{"oneOf":[{"type":"string","title":"Requestid","description":"Equals the `X-Request-ID` response header. Quote it to support.","example":"8d32789e-7b27-44f7-9523-424596e7a929","uniqueKey":"requestId.oneOf.0","typeLabel":"string"},{"type":"null","title":"Requestid","description":"Equals the `X-Request-ID` response header. Quote it to support.","example":"8d32789e-7b27-44f7-9523-424596e7a929","uniqueKey":"requestId.oneOf.1","typeLabel":"null"}],"uniqueKey":"requestId","typeLabel":"string | null"},"retryable":{"oneOf":[{"type":"boolean","title":"Retryable","description":"True only when repeating the same request is safe and may succeed.","example":false,"uniqueKey":"retryable.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Retryable","description":"True only when repeating the same request is safe and may succeed.","example":false,"uniqueKey":"retryable.oneOf.1","typeLabel":"null"}],"uniqueKey":"retryable","typeLabel":"boolean | null"},"retryAfterSeconds":{"oneOf":[{"type":"integer","title":"Retryafterseconds","description":"On 429 and 503 when `Retry-After` is set: the same value in seconds.","example":30,"uniqueKey":"retryAfterSeconds.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Retryafterseconds","description":"On 429 and 503 when `Retry-After` is set: the same value in seconds.","example":30,"uniqueKey":"retryAfterSeconds.oneOf.1","typeLabel":"null"}],"uniqueKey":"retryAfterSeconds","typeLabel":"integer | null"},"actId":{"oneOf":[{"type":"string","title":"Actid","description":"Section routes only, on a miss: the identifier that matched nothing.","example":"USC_99_9999","uniqueKey":"actId.oneOf.0","typeLabel":"string"},{"type":"null","title":"Actid","description":"Section routes only, on a miss: the identifier that matched nothing.","example":"USC_99_9999","uniqueKey":"actId.oneOf.1","typeLabel":"null"}],"uniqueKey":"actId","typeLabel":"string | null"},"reason":{"oneOf":[{"type":"string","title":"Reason","description":"Section routes only, on a miss: why nothing matched, for example `unsupported_jurisdiction` or `not_in_registry`. The set is open.","example":"not_in_registry","uniqueKey":"reason.oneOf.0","typeLabel":"string"},{"type":"null","title":"Reason","description":"Section routes only, on a miss: why nothing matched, for example `unsupported_jurisdiction` or `not_in_registry`. The set is open.","example":"not_in_registry","uniqueKey":"reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"reason","typeLabel":"string | null"},"didYouMean":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"didYouMean.oneOf.0.items.[INDEX]","typeLabel":"string"},"title":"Didyoumean","description":"Section routes only, on a miss: identifiers worth trying instead.","uniqueKey":"didYouMean.oneOf.0","typeLabel":"string[]"},{"type":"null","title":"Didyoumean","description":"Section routes only, on a miss: identifiers worth trying instead.","uniqueKey":"didYouMean.oneOf.1","typeLabel":"null"}],"uniqueKey":"didYouMean","typeLabel":"string[] | null"}},"type":"object","required":["detail"],"title":"ApiDetailError","description":"Error envelope the API actually returns.\n\nEvery error (400/401/402/403/404/405/422/429/5xx) carries a `detail`\nstring, e.g. `{\"detail\": \"Insufficient API credits.\"}`, on every mount of\nthe API. A 422 adds `errors`, one entry per rejected field. Some 404s add\nendpoint-specific diagnosis beside `detail` (the statutes section routes\nadd `actId`, `reason` and `didYouMean`); treat unknown keys as optional.","uniqueKey":"","typeLabel":"ApiDetailError · object"},"examples":{"Example":{"title":"Example","value":{"detail":"Insufficient API credits.","errors":[{"loc":["body","corpusType"],"msg":"Input should be 'USC', 'CFR' or 'STATE'","type":"literal_error"}],"code":"insufficient_credits","type":"https://www.vaquill.ai/docs/errors/insufficient_credits","title":"Insufficient credits","status":402,"requestId":"8d32789e-7b27-44f7-9523-424596e7a929","retryable":false,"retryAfterSeconds":30,"actId":"USC_99_9999","reason":"not_in_registry","didYouMean":["\u003cstring>"]}}},"exampleType":"generated"}},"headers":{"X-RateLimit-Limit":{"description":"Requests allowed in the current per-minute window.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current per-minute window.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp at which the per-minute window resets.","schema":{"type":"integer"}},"X-RateLimit-Limit-Day":{"description":"Requests allowed per day (the slow-drip backstop).","schema":{"type":"integer"}},"X-RateLimit-Remaining-Day":{"description":"Requests left in the daily window.","schema":{"type":"integer"}},"X-Request-ID":{"description":"Correlation id of this request. Quote it when contacting support.","schema":{"type":"string"}}},"exampleType":"generated"},"c46286eb-c2a6-46ae-b912-f30bda70be33":{"description":"A parameter failed validation: `jurisdiction` missing or not a state, a malformed filter or date (`enactmentOutcome` outside its vocabulary, `q` shorter than 3 characters), `limit` out of range, or a `cursor` we did not issue. Never charged. `errors[].loc` names the parameter exactly as you send it. `idempotency_key_reused`: the `Idempotency-Key` was already used with a different request.","content":{"application/json":{"examples":{"missingJurisdiction":{"title":"missingJurisdiction","value":{"detail":"Invalid request parameters","errors":[{"loc":["query","jurisdiction"],"msg":"Field required","type":"missing"}]}},"federalJurisdiction":{"title":"federalJurisdiction","value":{"detail":"Invalid request parameters","errors":[{"loc":["query","jurisdiction"],"msg":"Value error, Unknown `jurisdiction` value 'federal'. Expected one of: al, ak, as, az, ar, ca, co, ct, de, dc, fl, ga, gu, hi, id, il, in, ia, ks, ky, la, me, md, ma, mi, mn, ms, mo, mt, ne, nv, nh, nj, nm, ny, nc, nd, mp, oh, ok, or, pa, pr, ri, sc, sd, tn, tx, ut, vt, vi, va, wa, wv, wi, wy.","type":"value_error"}]}},"impossibleDate":{"title":"impossibleDate","value":{"detail":"Invalid request parameters","errors":[{"loc":["query","effectiveFrom"],"msg":"Value error, `effectiveFrom` must be a real calendar date in YYYY-MM-DD form.","type":"value_error"}]}},"limitTooLarge":{"title":"limitTooLarge","value":{"detail":"Invalid request parameters","errors":[{"loc":["query","limit"],"msg":"Input should be less than or equal to 200","type":"less_than_equal"}]}},"badEnactmentOutcome":{"title":"badEnactmentOutcome","value":{"detail":"Invalid request parameters","errors":[{"loc":["query","enactmentOutcome",0],"msg":"Input should be 'signed', 'became_law_without_signature', 'veto_overridden', 'line_item_veto', 'vetoed', 'pocket_veto', 'not_presented', 'approved_by_voters' or 'unknown'","type":"literal_error"}]}},"qTooShort":{"title":"qTooShort","value":{"detail":"Invalid request parameters","errors":[{"loc":["query","q"],"msg":"String should have at least 3 characters","type":"string_too_short"}]}},"impossibleUpdatedSince":{"title":"impossibleUpdatedSince","value":{"detail":"Invalid request parameters","errors":[{"loc":["query","updatedSince"],"msg":"Value error, `updatedSince` must be a real calendar date in YYYY-MM-DD form.","type":"value_error"}]}},"badTextStatus":{"title":"badTextStatus","value":{"detail":"Invalid request parameters","errors":[{"loc":["query","textStatus"],"msg":"Input should be 'held', 'withheld', 'not_held' or 'pending'","type":"literal_error"}]}},"reversedDateRange":{"title":"reversedDateRange","value":{"detail":"`effectiveFrom` (2025-09-30) must not be after `effectiveTo` (2025-09-01). Swap them, or send the same date to both for a single day."}},"badCursor":{"title":"badCursor","value":{"detail":"`cursor` is not one this API issued.","reason":"invalid_cursor"}},"cursorQueryMismatch":{"title":"cursorQueryMismatch","value":{"detail":"`cursor` was issued for a different query. Send it only with the filters that produced it, or restart without `cursor`.","reason":"cursor_query_mismatch"}},"cursorExpired":{"title":"cursorExpired","value":{"detail":"`cursor` is from an earlier version of this API and has expired. Restart without `cursor`.","reason":"cursor_expired"}}},"schema":{"properties":{"detail":{"type":"string","title":"Detail","description":"Human-readable reason, safe to surface to an end user. Branch on the HTTP status rather than on this string: the wording is not part of the contract and may be reworded, but 401 (bad key), 402 (out of credits), 403 (missing scope), 404 (no such resource) and 429 (rate limited) are stable.","examples":["Insufficient API credits."],"isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"errors":{"oneOf":[{"type":"array","items":{"properties":{"loc":{"items":{"oneOf":[{"type":"string","uniqueKey":"errors.oneOf.0.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"errors.oneOf.0.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"errors.oneOf.0.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"type":"array","title":"Loc","description":"Where the bad value is: `body`, `query` or `path`, then the parameter name exactly as you send it (camelCase), then list indexes. A bare `[\"body\"]` means the body as a whole was not a JSON object.","examples":[["body","corpusType"]],"isRequired":true,"uniqueKey":"errors.oneOf.0.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"type":"string","title":"Msg","description":"What is wrong with the value, in plain English.","examples":["Input should be 'USC', 'CFR' or 'STATE'"],"isRequired":true,"uniqueKey":"errors.oneOf.0.items.[INDEX].msg","typeLabel":"string"},"type":{"type":"string","title":"Type","description":"Machine-readable error kind, e.g. `missing`, `literal_error`, `json_invalid`.","examples":["literal_error"],"isRequired":true,"uniqueKey":"errors.oneOf.0.items.[INDEX].type","typeLabel":"string"}},"type":"object","required":["loc","msg","type"],"title":"ApiFieldError","description":"One rejected field in a 422 response.","uniqueKey":"errors.oneOf.0.items.[INDEX]","typeLabel":"ApiFieldError · object"},"title":"Errors","description":"Present on 422 only: every field that failed validation.","uniqueKey":"errors.oneOf.0","typeLabel":"ApiFieldError · object[]"},{"type":"null","title":"Errors","description":"Present on 422 only: every field that failed validation.","uniqueKey":"errors.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors","typeLabel":"ApiFieldError · object[] | null"},"code":{"oneOf":[{"type":"string","title":"Code","description":"Stable machine code for the failure. Branch on this, not on `detail`. The set is open: tolerate values you do not know. Known values: authentication_required, invalid_api_key, api_key_expired, permission_denied, insufficient_scope, insufficient_credits, rate_limited, daily_cap_exceeded, validation_error, invalid_query, invalid_citation_input, section_not_found, resource_not_found, idempotency_key_reused, idempotency_in_progress, idempotency_replay_unavailable, upstream_timeout, service_unavailable, internal_error, conflict.","x-known-values":["authentication_required","invalid_api_key","api_key_expired","permission_denied","insufficient_scope","insufficient_credits","rate_limited","daily_cap_exceeded","validation_error","invalid_query","invalid_citation_input","section_not_found","resource_not_found","idempotency_key_reused","idempotency_in_progress","idempotency_replay_unavailable","upstream_timeout","service_unavailable","internal_error","conflict"],"example":"insufficient_credits","uniqueKey":"code.oneOf.0","typeLabel":"string"},{"type":"null","title":"Code","description":"Stable machine code for the failure. Branch on this, not on `detail`. The set is open: tolerate values you do not know. Known values: authentication_required, invalid_api_key, api_key_expired, permission_denied, insufficient_scope, insufficient_credits, rate_limited, daily_cap_exceeded, validation_error, invalid_query, invalid_citation_input, section_not_found, resource_not_found, idempotency_key_reused, idempotency_in_progress, idempotency_replay_unavailable, upstream_timeout, service_unavailable, internal_error, conflict.","x-known-values":["authentication_required","invalid_api_key","api_key_expired","permission_denied","insufficient_scope","insufficient_credits","rate_limited","daily_cap_exceeded","validation_error","invalid_query","invalid_citation_input","section_not_found","resource_not_found","idempotency_key_reused","idempotency_in_progress","idempotency_replay_unavailable","upstream_timeout","service_unavailable","internal_error","conflict"],"example":"insufficient_credits","uniqueKey":"code.oneOf.1","typeLabel":"null"}],"uniqueKey":"code","typeLabel":"string | null"},"type":{"oneOf":[{"type":"string","title":"Type","description":"URL naming the error kind, `https://www.vaquill.ai/docs/errors/{code}`.","example":"https://www.vaquill.ai/docs/errors/insufficient_credits","uniqueKey":"type.oneOf.0","typeLabel":"string"},{"type":"null","title":"Type","description":"URL naming the error kind, `https://www.vaquill.ai/docs/errors/{code}`.","example":"https://www.vaquill.ai/docs/errors/insufficient_credits","uniqueKey":"type.oneOf.1","typeLabel":"null"}],"uniqueKey":"type","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","title":"Title","description":"Short fixed English title for `code`.","example":"Insufficient credits","uniqueKey":"title.oneOf.0","typeLabel":"string"},{"type":"null","title":"Title","description":"Short fixed English title for `code`.","example":"Insufficient credits","uniqueKey":"title.oneOf.1","typeLabel":"null"}],"uniqueKey":"title","typeLabel":"string | null"},"status":{"oneOf":[{"type":"integer","title":"Status","description":"Echo of the HTTP status code.","example":402,"uniqueKey":"status.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Status","description":"Echo of the HTTP status code.","example":402,"uniqueKey":"status.oneOf.1","typeLabel":"null"}],"uniqueKey":"status","typeLabel":"integer | null"},"requestId":{"oneOf":[{"type":"string","title":"Requestid","description":"Equals the `X-Request-ID` response header. Quote it to support.","example":"8d32789e-7b27-44f7-9523-424596e7a929","uniqueKey":"requestId.oneOf.0","typeLabel":"string"},{"type":"null","title":"Requestid","description":"Equals the `X-Request-ID` response header. Quote it to support.","example":"8d32789e-7b27-44f7-9523-424596e7a929","uniqueKey":"requestId.oneOf.1","typeLabel":"null"}],"uniqueKey":"requestId","typeLabel":"string | null"},"retryable":{"oneOf":[{"type":"boolean","title":"Retryable","description":"True only when repeating the same request is safe and may succeed.","example":false,"uniqueKey":"retryable.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Retryable","description":"True only when repeating the same request is safe and may succeed.","example":false,"uniqueKey":"retryable.oneOf.1","typeLabel":"null"}],"uniqueKey":"retryable","typeLabel":"boolean | null"},"retryAfterSeconds":{"oneOf":[{"type":"integer","title":"Retryafterseconds","description":"On 429 and 503 when `Retry-After` is set: the same value in seconds.","example":30,"uniqueKey":"retryAfterSeconds.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Retryafterseconds","description":"On 429 and 503 when `Retry-After` is set: the same value in seconds.","example":30,"uniqueKey":"retryAfterSeconds.oneOf.1","typeLabel":"null"}],"uniqueKey":"retryAfterSeconds","typeLabel":"integer | null"},"actId":{"oneOf":[{"type":"string","title":"Actid","description":"Section routes only, on a miss: the identifier that matched nothing.","example":"USC_99_9999","uniqueKey":"actId.oneOf.0","typeLabel":"string"},{"type":"null","title":"Actid","description":"Section routes only, on a miss: the identifier that matched nothing.","example":"USC_99_9999","uniqueKey":"actId.oneOf.1","typeLabel":"null"}],"uniqueKey":"actId","typeLabel":"string | null"},"reason":{"oneOf":[{"type":"string","title":"Reason","description":"Section routes only, on a miss: why nothing matched, for example `unsupported_jurisdiction` or `not_in_registry`. The set is open.","example":"not_in_registry","uniqueKey":"reason.oneOf.0","typeLabel":"string"},{"type":"null","title":"Reason","description":"Section routes only, on a miss: why nothing matched, for example `unsupported_jurisdiction` or `not_in_registry`. The set is open.","example":"not_in_registry","uniqueKey":"reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"reason","typeLabel":"string | null"},"didYouMean":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"didYouMean.oneOf.0.items.[INDEX]","typeLabel":"string"},"title":"Didyoumean","description":"Section routes only, on a miss: identifiers worth trying instead.","uniqueKey":"didYouMean.oneOf.0","typeLabel":"string[]"},{"type":"null","title":"Didyoumean","description":"Section routes only, on a miss: identifiers worth trying instead.","uniqueKey":"didYouMean.oneOf.1","typeLabel":"null"}],"uniqueKey":"didYouMean","typeLabel":"string[] | null"}},"type":"object","required":["detail"],"title":"ApiDetailError","description":"Error envelope the API actually returns.\n\nEvery error (400/401/402/403/404/405/422/429/5xx) carries a `detail`\nstring, e.g. `{\"detail\": \"Insufficient API credits.\"}`, on every mount of\nthe API. A 422 adds `errors`, one entry per rejected field. Some 404s add\nendpoint-specific diagnosis beside `detail` (the statutes section routes\nadd `actId`, `reason` and `didYouMean`); treat unknown keys as optional.","uniqueKey":"","typeLabel":"ApiDetailError · object"},"exampleType":"examples"}},"headers":{"X-RateLimit-Limit":{"description":"Requests allowed in the current per-minute window.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current per-minute window.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp at which the per-minute window resets.","schema":{"type":"integer"}},"X-RateLimit-Limit-Day":{"description":"Requests allowed per day (the slow-drip backstop).","schema":{"type":"integer"}},"X-RateLimit-Remaining-Day":{"description":"Requests left in the daily window.","schema":{"type":"integer"}},"X-Request-ID":{"description":"Correlation id of this request. Quote it when contacting support.","schema":{"type":"string"}}},"exampleType":"examples"},"ca8669a0-f5ca-4c6a-ad95-6960bd295c06":{"description":"Rate limit exceeded for your key. Not charged. Wait `Retry-After` seconds.","headers":{"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer"}},"X-RateLimit-Limit":{"description":"Requests allowed in the current per-minute window.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current per-minute window.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp at which the per-minute window resets.","schema":{"type":"integer"}},"X-RateLimit-Limit-Day":{"description":"Requests allowed per day (the slow-drip backstop).","schema":{"type":"integer"}},"X-RateLimit-Remaining-Day":{"description":"Requests left in the daily window.","schema":{"type":"integer"}},"X-Request-ID":{"description":"Correlation id of this request. Quote it when contacting support.","schema":{"type":"string"}}},"content":{"application/json":{"example":{"detail":"Rate limit exceeded. Try again in 12 seconds."},"schema":{"properties":{"detail":{"type":"string","title":"Detail","description":"Human-readable reason, safe to surface to an end user. Branch on the HTTP status rather than on this string: the wording is not part of the contract and may be reworded, but 401 (bad key), 402 (out of credits), 403 (missing scope), 404 (no such resource) and 429 (rate limited) are stable.","examples":["Insufficient API credits."],"isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"errors":{"oneOf":[{"type":"array","items":{"properties":{"loc":{"items":{"oneOf":[{"type":"string","uniqueKey":"errors.oneOf.0.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"errors.oneOf.0.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"errors.oneOf.0.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"type":"array","title":"Loc","description":"Where the bad value is: `body`, `query` or `path`, then the parameter name exactly as you send it (camelCase), then list indexes. A bare `[\"body\"]` means the body as a whole was not a JSON object.","examples":[["body","corpusType"]],"isRequired":true,"uniqueKey":"errors.oneOf.0.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"type":"string","title":"Msg","description":"What is wrong with the value, in plain English.","examples":["Input should be 'USC', 'CFR' or 'STATE'"],"isRequired":true,"uniqueKey":"errors.oneOf.0.items.[INDEX].msg","typeLabel":"string"},"type":{"type":"string","title":"Type","description":"Machine-readable error kind, e.g. `missing`, `literal_error`, `json_invalid`.","examples":["literal_error"],"isRequired":true,"uniqueKey":"errors.oneOf.0.items.[INDEX].type","typeLabel":"string"}},"type":"object","required":["loc","msg","type"],"title":"ApiFieldError","description":"One rejected field in a 422 response.","uniqueKey":"errors.oneOf.0.items.[INDEX]","typeLabel":"ApiFieldError · object"},"title":"Errors","description":"Present on 422 only: every field that failed validation.","uniqueKey":"errors.oneOf.0","typeLabel":"ApiFieldError · object[]"},{"type":"null","title":"Errors","description":"Present on 422 only: every field that failed validation.","uniqueKey":"errors.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors","typeLabel":"ApiFieldError · object[] | null"},"code":{"oneOf":[{"type":"string","title":"Code","description":"Stable machine code for the failure. Branch on this, not on `detail`. The set is open: tolerate values you do not know. Known values: authentication_required, invalid_api_key, api_key_expired, permission_denied, insufficient_scope, insufficient_credits, rate_limited, daily_cap_exceeded, validation_error, invalid_query, invalid_citation_input, section_not_found, resource_not_found, idempotency_key_reused, idempotency_in_progress, idempotency_replay_unavailable, upstream_timeout, service_unavailable, internal_error, conflict.","x-known-values":["authentication_required","invalid_api_key","api_key_expired","permission_denied","insufficient_scope","insufficient_credits","rate_limited","daily_cap_exceeded","validation_error","invalid_query","invalid_citation_input","section_not_found","resource_not_found","idempotency_key_reused","idempotency_in_progress","idempotency_replay_unavailable","upstream_timeout","service_unavailable","internal_error","conflict"],"example":"insufficient_credits","uniqueKey":"code.oneOf.0","typeLabel":"string"},{"type":"null","title":"Code","description":"Stable machine code for the failure. Branch on this, not on `detail`. The set is open: tolerate values you do not know. Known values: authentication_required, invalid_api_key, api_key_expired, permission_denied, insufficient_scope, insufficient_credits, rate_limited, daily_cap_exceeded, validation_error, invalid_query, invalid_citation_input, section_not_found, resource_not_found, idempotency_key_reused, idempotency_in_progress, idempotency_replay_unavailable, upstream_timeout, service_unavailable, internal_error, conflict.","x-known-values":["authentication_required","invalid_api_key","api_key_expired","permission_denied","insufficient_scope","insufficient_credits","rate_limited","daily_cap_exceeded","validation_error","invalid_query","invalid_citation_input","section_not_found","resource_not_found","idempotency_key_reused","idempotency_in_progress","idempotency_replay_unavailable","upstream_timeout","service_unavailable","internal_error","conflict"],"example":"insufficient_credits","uniqueKey":"code.oneOf.1","typeLabel":"null"}],"uniqueKey":"code","typeLabel":"string | null"},"type":{"oneOf":[{"type":"string","title":"Type","description":"URL naming the error kind, `https://www.vaquill.ai/docs/errors/{code}`.","example":"https://www.vaquill.ai/docs/errors/insufficient_credits","uniqueKey":"type.oneOf.0","typeLabel":"string"},{"type":"null","title":"Type","description":"URL naming the error kind, `https://www.vaquill.ai/docs/errors/{code}`.","example":"https://www.vaquill.ai/docs/errors/insufficient_credits","uniqueKey":"type.oneOf.1","typeLabel":"null"}],"uniqueKey":"type","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","title":"Title","description":"Short fixed English title for `code`.","example":"Insufficient credits","uniqueKey":"title.oneOf.0","typeLabel":"string"},{"type":"null","title":"Title","description":"Short fixed English title for `code`.","example":"Insufficient credits","uniqueKey":"title.oneOf.1","typeLabel":"null"}],"uniqueKey":"title","typeLabel":"string | null"},"status":{"oneOf":[{"type":"integer","title":"Status","description":"Echo of the HTTP status code.","example":402,"uniqueKey":"status.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Status","description":"Echo of the HTTP status code.","example":402,"uniqueKey":"status.oneOf.1","typeLabel":"null"}],"uniqueKey":"status","typeLabel":"integer | null"},"requestId":{"oneOf":[{"type":"string","title":"Requestid","description":"Equals the `X-Request-ID` response header. Quote it to support.","example":"8d32789e-7b27-44f7-9523-424596e7a929","uniqueKey":"requestId.oneOf.0","typeLabel":"string"},{"type":"null","title":"Requestid","description":"Equals the `X-Request-ID` response header. Quote it to support.","example":"8d32789e-7b27-44f7-9523-424596e7a929","uniqueKey":"requestId.oneOf.1","typeLabel":"null"}],"uniqueKey":"requestId","typeLabel":"string | null"},"retryable":{"oneOf":[{"type":"boolean","title":"Retryable","description":"True only when repeating the same request is safe and may succeed.","example":false,"uniqueKey":"retryable.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Retryable","description":"True only when repeating the same request is safe and may succeed.","example":false,"uniqueKey":"retryable.oneOf.1","typeLabel":"null"}],"uniqueKey":"retryable","typeLabel":"boolean | null"},"retryAfterSeconds":{"oneOf":[{"type":"integer","title":"Retryafterseconds","description":"On 429 and 503 when `Retry-After` is set: the same value in seconds.","example":30,"uniqueKey":"retryAfterSeconds.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Retryafterseconds","description":"On 429 and 503 when `Retry-After` is set: the same value in seconds.","example":30,"uniqueKey":"retryAfterSeconds.oneOf.1","typeLabel":"null"}],"uniqueKey":"retryAfterSeconds","typeLabel":"integer | null"},"actId":{"oneOf":[{"type":"string","title":"Actid","description":"Section routes only, on a miss: the identifier that matched nothing.","example":"USC_99_9999","uniqueKey":"actId.oneOf.0","typeLabel":"string"},{"type":"null","title":"Actid","description":"Section routes only, on a miss: the identifier that matched nothing.","example":"USC_99_9999","uniqueKey":"actId.oneOf.1","typeLabel":"null"}],"uniqueKey":"actId","typeLabel":"string | null"},"reason":{"oneOf":[{"type":"string","title":"Reason","description":"Section routes only, on a miss: why nothing matched, for example `unsupported_jurisdiction` or `not_in_registry`. The set is open.","example":"not_in_registry","uniqueKey":"reason.oneOf.0","typeLabel":"string"},{"type":"null","title":"Reason","description":"Section routes only, on a miss: why nothing matched, for example `unsupported_jurisdiction` or `not_in_registry`. The set is open.","example":"not_in_registry","uniqueKey":"reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"reason","typeLabel":"string | null"},"didYouMean":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"didYouMean.oneOf.0.items.[INDEX]","typeLabel":"string"},"title":"Didyoumean","description":"Section routes only, on a miss: identifiers worth trying instead.","uniqueKey":"didYouMean.oneOf.0","typeLabel":"string[]"},{"type":"null","title":"Didyoumean","description":"Section routes only, on a miss: identifiers worth trying instead.","uniqueKey":"didYouMean.oneOf.1","typeLabel":"null"}],"uniqueKey":"didYouMean","typeLabel":"string[] | null"}},"type":"object","required":["detail"],"title":"ApiDetailError","description":"Error envelope the API actually returns.\n\nEvery error (400/401/402/403/404/405/422/429/5xx) carries a `detail`\nstring, e.g. `{\"detail\": \"Insufficient API credits.\"}`, on every mount of\nthe API. A 422 adds `errors`, one entry per rejected field. Some 404s add\nendpoint-specific diagnosis beside `detail` (the statutes section routes\nadd `actId`, `reason` and `didYouMean`); treat unknown keys as optional.","uniqueKey":"","typeLabel":"ApiDetailError · object"},"examples":{"Example":{"title":"Example","value":{"detail":"Rate limit exceeded. Try again in 12 seconds."}}},"exampleType":"examples"}},"exampleType":"examples"},"6d7c7479-05de-477e-be86-1ba3801b290e":{"description":"An unexpected failure on our side. The charge is refunded.","content":{"application/json":{"example":{"detail":"Internal server error"},"schema":{"properties":{"detail":{"type":"string","title":"Detail","description":"Human-readable reason, safe to surface to an end user. Branch on the HTTP status rather than on this string: the wording is not part of the contract and may be reworded, but 401 (bad key), 402 (out of credits), 403 (missing scope), 404 (no such resource) and 429 (rate limited) are stable.","examples":["Insufficient API credits."],"isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"errors":{"oneOf":[{"type":"array","items":{"properties":{"loc":{"items":{"oneOf":[{"type":"string","uniqueKey":"errors.oneOf.0.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"errors.oneOf.0.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"errors.oneOf.0.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"type":"array","title":"Loc","description":"Where the bad value is: `body`, `query` or `path`, then the parameter name exactly as you send it (camelCase), then list indexes. A bare `[\"body\"]` means the body as a whole was not a JSON object.","examples":[["body","corpusType"]],"isRequired":true,"uniqueKey":"errors.oneOf.0.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"type":"string","title":"Msg","description":"What is wrong with the value, in plain English.","examples":["Input should be 'USC', 'CFR' or 'STATE'"],"isRequired":true,"uniqueKey":"errors.oneOf.0.items.[INDEX].msg","typeLabel":"string"},"type":{"type":"string","title":"Type","description":"Machine-readable error kind, e.g. `missing`, `literal_error`, `json_invalid`.","examples":["literal_error"],"isRequired":true,"uniqueKey":"errors.oneOf.0.items.[INDEX].type","typeLabel":"string"}},"type":"object","required":["loc","msg","type"],"title":"ApiFieldError","description":"One rejected field in a 422 response.","uniqueKey":"errors.oneOf.0.items.[INDEX]","typeLabel":"ApiFieldError · object"},"title":"Errors","description":"Present on 422 only: every field that failed validation.","uniqueKey":"errors.oneOf.0","typeLabel":"ApiFieldError · object[]"},{"type":"null","title":"Errors","description":"Present on 422 only: every field that failed validation.","uniqueKey":"errors.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors","typeLabel":"ApiFieldError · object[] | null"},"code":{"oneOf":[{"type":"string","title":"Code","description":"Stable machine code for the failure. Branch on this, not on `detail`. The set is open: tolerate values you do not know. Known values: authentication_required, invalid_api_key, api_key_expired, permission_denied, insufficient_scope, insufficient_credits, rate_limited, daily_cap_exceeded, validation_error, invalid_query, invalid_citation_input, section_not_found, resource_not_found, idempotency_key_reused, idempotency_in_progress, idempotency_replay_unavailable, upstream_timeout, service_unavailable, internal_error, conflict.","x-known-values":["authentication_required","invalid_api_key","api_key_expired","permission_denied","insufficient_scope","insufficient_credits","rate_limited","daily_cap_exceeded","validation_error","invalid_query","invalid_citation_input","section_not_found","resource_not_found","idempotency_key_reused","idempotency_in_progress","idempotency_replay_unavailable","upstream_timeout","service_unavailable","internal_error","conflict"],"example":"insufficient_credits","uniqueKey":"code.oneOf.0","typeLabel":"string"},{"type":"null","title":"Code","description":"Stable machine code for the failure. Branch on this, not on `detail`. The set is open: tolerate values you do not know. Known values: authentication_required, invalid_api_key, api_key_expired, permission_denied, insufficient_scope, insufficient_credits, rate_limited, daily_cap_exceeded, validation_error, invalid_query, invalid_citation_input, section_not_found, resource_not_found, idempotency_key_reused, idempotency_in_progress, idempotency_replay_unavailable, upstream_timeout, service_unavailable, internal_error, conflict.","x-known-values":["authentication_required","invalid_api_key","api_key_expired","permission_denied","insufficient_scope","insufficient_credits","rate_limited","daily_cap_exceeded","validation_error","invalid_query","invalid_citation_input","section_not_found","resource_not_found","idempotency_key_reused","idempotency_in_progress","idempotency_replay_unavailable","upstream_timeout","service_unavailable","internal_error","conflict"],"example":"insufficient_credits","uniqueKey":"code.oneOf.1","typeLabel":"null"}],"uniqueKey":"code","typeLabel":"string | null"},"type":{"oneOf":[{"type":"string","title":"Type","description":"URL naming the error kind, `https://www.vaquill.ai/docs/errors/{code}`.","example":"https://www.vaquill.ai/docs/errors/insufficient_credits","uniqueKey":"type.oneOf.0","typeLabel":"string"},{"type":"null","title":"Type","description":"URL naming the error kind, `https://www.vaquill.ai/docs/errors/{code}`.","example":"https://www.vaquill.ai/docs/errors/insufficient_credits","uniqueKey":"type.oneOf.1","typeLabel":"null"}],"uniqueKey":"type","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","title":"Title","description":"Short fixed English title for `code`.","example":"Insufficient credits","uniqueKey":"title.oneOf.0","typeLabel":"string"},{"type":"null","title":"Title","description":"Short fixed English title for `code`.","example":"Insufficient credits","uniqueKey":"title.oneOf.1","typeLabel":"null"}],"uniqueKey":"title","typeLabel":"string | null"},"status":{"oneOf":[{"type":"integer","title":"Status","description":"Echo of the HTTP status code.","example":402,"uniqueKey":"status.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Status","description":"Echo of the HTTP status code.","example":402,"uniqueKey":"status.oneOf.1","typeLabel":"null"}],"uniqueKey":"status","typeLabel":"integer | null"},"requestId":{"oneOf":[{"type":"string","title":"Requestid","description":"Equals the `X-Request-ID` response header. Quote it to support.","example":"8d32789e-7b27-44f7-9523-424596e7a929","uniqueKey":"requestId.oneOf.0","typeLabel":"string"},{"type":"null","title":"Requestid","description":"Equals the `X-Request-ID` response header. Quote it to support.","example":"8d32789e-7b27-44f7-9523-424596e7a929","uniqueKey":"requestId.oneOf.1","typeLabel":"null"}],"uniqueKey":"requestId","typeLabel":"string | null"},"retryable":{"oneOf":[{"type":"boolean","title":"Retryable","description":"True only when repeating the same request is safe and may succeed.","example":false,"uniqueKey":"retryable.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Retryable","description":"True only when repeating the same request is safe and may succeed.","example":false,"uniqueKey":"retryable.oneOf.1","typeLabel":"null"}],"uniqueKey":"retryable","typeLabel":"boolean | null"},"retryAfterSeconds":{"oneOf":[{"type":"integer","title":"Retryafterseconds","description":"On 429 and 503 when `Retry-After` is set: the same value in seconds.","example":30,"uniqueKey":"retryAfterSeconds.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Retryafterseconds","description":"On 429 and 503 when `Retry-After` is set: the same value in seconds.","example":30,"uniqueKey":"retryAfterSeconds.oneOf.1","typeLabel":"null"}],"uniqueKey":"retryAfterSeconds","typeLabel":"integer | null"},"actId":{"oneOf":[{"type":"string","title":"Actid","description":"Section routes only, on a miss: the identifier that matched nothing.","example":"USC_99_9999","uniqueKey":"actId.oneOf.0","typeLabel":"string"},{"type":"null","title":"Actid","description":"Section routes only, on a miss: the identifier that matched nothing.","example":"USC_99_9999","uniqueKey":"actId.oneOf.1","typeLabel":"null"}],"uniqueKey":"actId","typeLabel":"string | null"},"reason":{"oneOf":[{"type":"string","title":"Reason","description":"Section routes only, on a miss: why nothing matched, for example `unsupported_jurisdiction` or `not_in_registry`. The set is open.","example":"not_in_registry","uniqueKey":"reason.oneOf.0","typeLabel":"string"},{"type":"null","title":"Reason","description":"Section routes only, on a miss: why nothing matched, for example `unsupported_jurisdiction` or `not_in_registry`. The set is open.","example":"not_in_registry","uniqueKey":"reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"reason","typeLabel":"string | null"},"didYouMean":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"didYouMean.oneOf.0.items.[INDEX]","typeLabel":"string"},"title":"Didyoumean","description":"Section routes only, on a miss: identifiers worth trying instead.","uniqueKey":"didYouMean.oneOf.0","typeLabel":"string[]"},{"type":"null","title":"Didyoumean","description":"Section routes only, on a miss: identifiers worth trying instead.","uniqueKey":"didYouMean.oneOf.1","typeLabel":"null"}],"uniqueKey":"didYouMean","typeLabel":"string[] | null"}},"type":"object","required":["detail"],"title":"ApiDetailError","description":"Error envelope the API actually returns.\n\nEvery error (400/401/402/403/404/405/422/429/5xx) carries a `detail`\nstring, e.g. `{\"detail\": \"Insufficient API credits.\"}`, on every mount of\nthe API. A 422 adds `errors`, one entry per rejected field. Some 404s add\nendpoint-specific diagnosis beside `detail` (the statutes section routes\nadd `actId`, `reason` and `didYouMean`); treat unknown keys as optional.","uniqueKey":"","typeLabel":"ApiDetailError · object"},"examples":{"Example":{"title":"Example","value":{"detail":"Internal server error"}}},"exampleType":"examples"}},"headers":{"X-RateLimit-Limit":{"description":"Requests allowed in the current per-minute window.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current per-minute window.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp at which the per-minute window resets.","schema":{"type":"integer"}},"X-RateLimit-Limit-Day":{"description":"Requests allowed per day (the slow-drip backstop).","schema":{"type":"integer"}},"X-RateLimit-Remaining-Day":{"description":"Requests left in the daily window.","schema":{"type":"integer"}},"X-Request-ID":{"description":"Correlation id of this request. Quote it when contacting support.","schema":{"type":"string"}}},"exampleType":"examples"},"4f3a0241-8015-4569-a989-8b618dd0e65c":{"description":"The session-laws database is temporarily unavailable. The charge is refunded; retry.","content":{"application/json":{"example":{"detail":"The US session-laws database is temporarily unavailable. Please retry."},"schema":{"properties":{"detail":{"type":"string","title":"Detail","description":"Human-readable reason, safe to surface to an end user. Branch on the HTTP status rather than on this string: the wording is not part of the contract and may be reworded, but 401 (bad key), 402 (out of credits), 403 (missing scope), 404 (no such resource) and 429 (rate limited) are stable.","examples":["Insufficient API credits."],"isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"errors":{"oneOf":[{"type":"array","items":{"properties":{"loc":{"items":{"oneOf":[{"type":"string","uniqueKey":"errors.oneOf.0.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"errors.oneOf.0.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"errors.oneOf.0.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"type":"array","title":"Loc","description":"Where the bad value is: `body`, `query` or `path`, then the parameter name exactly as you send it (camelCase), then list indexes. A bare `[\"body\"]` means the body as a whole was not a JSON object.","examples":[["body","corpusType"]],"isRequired":true,"uniqueKey":"errors.oneOf.0.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"type":"string","title":"Msg","description":"What is wrong with the value, in plain English.","examples":["Input should be 'USC', 'CFR' or 'STATE'"],"isRequired":true,"uniqueKey":"errors.oneOf.0.items.[INDEX].msg","typeLabel":"string"},"type":{"type":"string","title":"Type","description":"Machine-readable error kind, e.g. `missing`, `literal_error`, `json_invalid`.","examples":["literal_error"],"isRequired":true,"uniqueKey":"errors.oneOf.0.items.[INDEX].type","typeLabel":"string"}},"type":"object","required":["loc","msg","type"],"title":"ApiFieldError","description":"One rejected field in a 422 response.","uniqueKey":"errors.oneOf.0.items.[INDEX]","typeLabel":"ApiFieldError · object"},"title":"Errors","description":"Present on 422 only: every field that failed validation.","uniqueKey":"errors.oneOf.0","typeLabel":"ApiFieldError · object[]"},{"type":"null","title":"Errors","description":"Present on 422 only: every field that failed validation.","uniqueKey":"errors.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors","typeLabel":"ApiFieldError · object[] | null"},"code":{"oneOf":[{"type":"string","title":"Code","description":"Stable machine code for the failure. Branch on this, not on `detail`. The set is open: tolerate values you do not know. Known values: authentication_required, invalid_api_key, api_key_expired, permission_denied, insufficient_scope, insufficient_credits, rate_limited, daily_cap_exceeded, validation_error, invalid_query, invalid_citation_input, section_not_found, resource_not_found, idempotency_key_reused, idempotency_in_progress, idempotency_replay_unavailable, upstream_timeout, service_unavailable, internal_error, conflict.","x-known-values":["authentication_required","invalid_api_key","api_key_expired","permission_denied","insufficient_scope","insufficient_credits","rate_limited","daily_cap_exceeded","validation_error","invalid_query","invalid_citation_input","section_not_found","resource_not_found","idempotency_key_reused","idempotency_in_progress","idempotency_replay_unavailable","upstream_timeout","service_unavailable","internal_error","conflict"],"example":"insufficient_credits","uniqueKey":"code.oneOf.0","typeLabel":"string"},{"type":"null","title":"Code","description":"Stable machine code for the failure. Branch on this, not on `detail`. The set is open: tolerate values you do not know. Known values: authentication_required, invalid_api_key, api_key_expired, permission_denied, insufficient_scope, insufficient_credits, rate_limited, daily_cap_exceeded, validation_error, invalid_query, invalid_citation_input, section_not_found, resource_not_found, idempotency_key_reused, idempotency_in_progress, idempotency_replay_unavailable, upstream_timeout, service_unavailable, internal_error, conflict.","x-known-values":["authentication_required","invalid_api_key","api_key_expired","permission_denied","insufficient_scope","insufficient_credits","rate_limited","daily_cap_exceeded","validation_error","invalid_query","invalid_citation_input","section_not_found","resource_not_found","idempotency_key_reused","idempotency_in_progress","idempotency_replay_unavailable","upstream_timeout","service_unavailable","internal_error","conflict"],"example":"insufficient_credits","uniqueKey":"code.oneOf.1","typeLabel":"null"}],"uniqueKey":"code","typeLabel":"string | null"},"type":{"oneOf":[{"type":"string","title":"Type","description":"URL naming the error kind, `https://www.vaquill.ai/docs/errors/{code}`.","example":"https://www.vaquill.ai/docs/errors/insufficient_credits","uniqueKey":"type.oneOf.0","typeLabel":"string"},{"type":"null","title":"Type","description":"URL naming the error kind, `https://www.vaquill.ai/docs/errors/{code}`.","example":"https://www.vaquill.ai/docs/errors/insufficient_credits","uniqueKey":"type.oneOf.1","typeLabel":"null"}],"uniqueKey":"type","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","title":"Title","description":"Short fixed English title for `code`.","example":"Insufficient credits","uniqueKey":"title.oneOf.0","typeLabel":"string"},{"type":"null","title":"Title","description":"Short fixed English title for `code`.","example":"Insufficient credits","uniqueKey":"title.oneOf.1","typeLabel":"null"}],"uniqueKey":"title","typeLabel":"string | null"},"status":{"oneOf":[{"type":"integer","title":"Status","description":"Echo of the HTTP status code.","example":402,"uniqueKey":"status.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Status","description":"Echo of the HTTP status code.","example":402,"uniqueKey":"status.oneOf.1","typeLabel":"null"}],"uniqueKey":"status","typeLabel":"integer | null"},"requestId":{"oneOf":[{"type":"string","title":"Requestid","description":"Equals the `X-Request-ID` response header. Quote it to support.","example":"8d32789e-7b27-44f7-9523-424596e7a929","uniqueKey":"requestId.oneOf.0","typeLabel":"string"},{"type":"null","title":"Requestid","description":"Equals the `X-Request-ID` response header. Quote it to support.","example":"8d32789e-7b27-44f7-9523-424596e7a929","uniqueKey":"requestId.oneOf.1","typeLabel":"null"}],"uniqueKey":"requestId","typeLabel":"string | null"},"retryable":{"oneOf":[{"type":"boolean","title":"Retryable","description":"True only when repeating the same request is safe and may succeed.","example":false,"uniqueKey":"retryable.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Retryable","description":"True only when repeating the same request is safe and may succeed.","example":false,"uniqueKey":"retryable.oneOf.1","typeLabel":"null"}],"uniqueKey":"retryable","typeLabel":"boolean | null"},"retryAfterSeconds":{"oneOf":[{"type":"integer","title":"Retryafterseconds","description":"On 429 and 503 when `Retry-After` is set: the same value in seconds.","example":30,"uniqueKey":"retryAfterSeconds.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Retryafterseconds","description":"On 429 and 503 when `Retry-After` is set: the same value in seconds.","example":30,"uniqueKey":"retryAfterSeconds.oneOf.1","typeLabel":"null"}],"uniqueKey":"retryAfterSeconds","typeLabel":"integer | null"},"actId":{"oneOf":[{"type":"string","title":"Actid","description":"Section routes only, on a miss: the identifier that matched nothing.","example":"USC_99_9999","uniqueKey":"actId.oneOf.0","typeLabel":"string"},{"type":"null","title":"Actid","description":"Section routes only, on a miss: the identifier that matched nothing.","example":"USC_99_9999","uniqueKey":"actId.oneOf.1","typeLabel":"null"}],"uniqueKey":"actId","typeLabel":"string | null"},"reason":{"oneOf":[{"type":"string","title":"Reason","description":"Section routes only, on a miss: why nothing matched, for example `unsupported_jurisdiction` or `not_in_registry`. The set is open.","example":"not_in_registry","uniqueKey":"reason.oneOf.0","typeLabel":"string"},{"type":"null","title":"Reason","description":"Section routes only, on a miss: why nothing matched, for example `unsupported_jurisdiction` or `not_in_registry`. The set is open.","example":"not_in_registry","uniqueKey":"reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"reason","typeLabel":"string | null"},"didYouMean":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"didYouMean.oneOf.0.items.[INDEX]","typeLabel":"string"},"title":"Didyoumean","description":"Section routes only, on a miss: identifiers worth trying instead.","uniqueKey":"didYouMean.oneOf.0","typeLabel":"string[]"},{"type":"null","title":"Didyoumean","description":"Section routes only, on a miss: identifiers worth trying instead.","uniqueKey":"didYouMean.oneOf.1","typeLabel":"null"}],"uniqueKey":"didYouMean","typeLabel":"string[] | null"}},"type":"object","required":["detail"],"title":"ApiDetailError","description":"Error envelope the API actually returns.\n\nEvery error (400/401/402/403/404/405/422/429/5xx) carries a `detail`\nstring, e.g. `{\"detail\": \"Insufficient API credits.\"}`, on every mount of\nthe API. A 422 adds `errors`, one entry per rejected field. Some 404s add\nendpoint-specific diagnosis beside `detail` (the statutes section routes\nadd `actId`, `reason` and `didYouMean`); treat unknown keys as optional.","uniqueKey":"","typeLabel":"ApiDetailError · object"},"examples":{"Example":{"title":"Example","value":{"detail":"The US session-laws database is temporarily unavailable. Please retry."}}},"exampleType":"examples"}},"headers":{"X-RateLimit-Limit":{"description":"Requests allowed in the current per-minute window.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current per-minute window.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp at which the per-minute window resets.","schema":{"type":"integer"}},"X-RateLimit-Limit-Day":{"description":"Requests allowed per day (the slow-drip backstop).","schema":{"type":"integer"}},"X-RateLimit-Remaining-Day":{"description":"Requests left in the daily window.","schema":{"type":"integer"}},"X-Request-ID":{"description":"Correlation id of this request. Quote it when contacting support.","schema":{"type":"string"}}},"exampleType":"examples"}},"security":{"507a4177-c353-457f-b275-c6e5689326cb":{"ApiKeyAuth":{"type":"http","scheme":"bearer","bearerFormat":"vq_key_*","description":"API key issued from the developer dashboard. Pass as `Authorization: Bearer vq_key_...` (preferred).","scopes":[],"schemeName":"ApiKeyAuth"}},"fd51ae53-9413-4b29-a7c2-32a68ced30e6":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"X-API-Key","description":"The same API key as a bare header value: `X-API-Key: vq_key_...`. Equivalent to the Bearer form.","scopes":[],"schemeName":"ApiKeyHeader"}}},"servers":{"72a9d95a-e7d7-4dbe-946e-0f3975dd0517":{"url":"https://api.vaquill.ai","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"vq_key_*","description":"API key issued from the developer dashboard. Pass as `Authorization: Bearer vq_key_...` (preferred).","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"API key issued from the developer dashboard. Pass as `Authorization: Bearer vq_key_...` (preferred).","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"ApiKeyAuth","name":"Authorization"}],"title":"ApiKeyAuth"},{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-Key","description":"The same API key as a bare header value: `X-API-Key: vq_key_...`. Equivalent to the Bearer form.","scopes":[],"schemeName":"ApiKeyHeader"},"schema":{"title":"X-API-Key","type":"string","description":"The same API key as a bare header value: `X-API-Key: vq_key_...`. Equivalent to the Bearer form.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyHeader","name":"X-API-Key"}],"title":"ApiKeyHeader"}]},"originalFileLocation":"https://api.vaquill.ai/external/openapi.json"},"subdomain":"vaquill","siteName":"Vaquill AI","title":"List a state's session laws - Vaquill AI","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"originalFileLocation":"api-reference/us-session-laws/list-a-states-session-laws.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"light\";if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"List the session laws of one state: every act its legislature enacted, filtered by session, approval date or effective date. This is how you ask \u0026quot;what became law in Texas this session\u0026quot;, \u0026quot;what was signed in April\u0026quot; or \u0026quot;what takes effect on September 1, 2025\u0026quot;, and how you turn the answer into sessionLawIds for the get and body endpoints. A session law is the act as enacted, before it is folded into a code; v1 serves STATE acts. Cost: 1 credit per page of up to 200 rows (default 50), however many rows the page holds. An empty page is an answer and is charged when it means nothing matches your filters. A request that fails validation (422) is never charged; a failure on our side (500, 503) is refunded. Empty pages. A page with no rows carries coverage, what we hold of the session you named (or of the state, when you named none), so you can tell \u0026quot;nothing matches\u0026quot; from \u0026quot;we have not collected this\u0026quot;. coverage.status is complete (we hold every law the publisher lists for it: the empty page is a true negative, and it is charged), partial (the collection stopped short, so the law you want may exist) or not_held (we hold nothing of it). On partial and not_held the page is NOT charged and creditsConsumed is 0: we do not bill an empty answer that may be our gap. The one exception is a request that names only the state, where some sessions we hold are complete and some partial: the page is charged, since for the complete ones it is a true negative, and coverage.partialSessions names the sessions to doubt (send one as session to ask about it alone). If coverage cannot be read the page is charged as before and coverage is omitted. Filters. jurisdiction is required and scopes everything; the rest narrow it and combine with AND. A value that is malformed is a 422, and so is a range whose end is before its start (approvedTo before approvedFrom, effectiveTo before effectiveFrom). A value that is well formed and matches nothing (an unknown session, a date range with no laws) is a 200 with results: []. Dates are YYYY-MM-DD. - Everything from one session: session (2025R, 2025S1). - Approved in a window: approvedFrom / approvedTo. - Taking effect in a window: effectiveFrom / effectiveTo. For one day send the same date to both. This matches laws whose first-to-last effective dates overlap your window, so read effectiveFirst and effectiveLast on each row and effectiveDates on the law. A law with no held effective date (not every state prints them) never matches. - Narrow by series, instrumentType, hasText or textStatus. - What became law and what did not: isLaw (false for the vetoed and pocket-vetoed measures; a measure whose outcome does not settle it has a null isLaw and matches neither value) and enactmentOutcome, repeated for several outcomes (enactmentOutcome=vetoed\u0026amp;enactmentOutcome=pocket_veto). - A sync job: updatedSince returns the laws whose record changed on or after a date (midnight UTC, by updatedAt), so a job that stores its last run pulls only what is new or corrected. - Find by words: q, a case-insensitive substring of the title or the bill number as the publisher prints it (3 to 100 characters). It is a substring match inside one state, not a search engine. - A derived approval date (approvedDateDerived: true) is not matched by approvedFrom and approvedTo, which read the registry\u0026#x27;s own approval date. Paging. Rows come in session.code order, then sessionLawId, both as TEXT in the database\u0026#x27;s collation, not in chapter order: ..._C10 sorts before ..._C2, and the id\u0026#x27;s series and numbering-year segments sort before the chapter. Sort client-side by number if you need chapter order. The order is the same on every page and for every filter, so a cursor never skips or repeats a row. Send nextCursor back as cursor, with the same filters, while hasMore is true (a cursor sent with different filters is a 422, cursor_query_mismatch: restart without it). The cursor is a keyset (it names the last row you saw), so laws added between your calls never repeat or skip a row you have passed. count is the size of this page, never a total. Text. Rows include laws whose text we do not hold (textStatus: not_held) or hold and withhold (withheld, with withheldReason): the row is still a real law. Pass hasText=true for just the laws /{sessionLawId}/body will serve. A row is the summary only: the full dates, sources and code sections are on GET /us/session-laws/{sessionLawId}. Each row carries charCount and estimatedBodyPages, so you can price reading a law before you open it. citableAs is the law cited the way a lawyer writes it (Minn. Laws 2025, ch. 1), and licenseNote says what its licence class permits. Cost of reading a law. Reading a whole law is estimatedBodyPages times the price of one body page (6 credits). Both are on the record: charCount is its length in characters and estimatedBodyPages is that divided by the page size (about 30,000 characters), rounded up, and null unless the text is served. Most acts take a page or two. The longest we hold, Ohio\u0026#x27;s 2025 budget act (HB 96, 9,571,132 characters), takes about 320 pages, 1,920 credits to read in full, so check estimatedBodyPages before you page through an omnibus act. Each body response then carries pagePrice (what that page cost) and estimatedRemainingCredits (the pages still to come times the price) so you can stop whenever you have enough. Example bash curl \u0026quot;https://api.vaquill.ai/api/v1/us/session-laws/list?jurisdiction=tx\u0026amp;effectiveFrom=2025-09-01\u0026amp;effectiveTo=2025-09-01\u0026amp;limit=25\u0026quot; \\ -H \u0026quot;Authorization: Bearer $VAQUILL_API_KEY\u0026quot; # only what changed since your last sync, and only measures that did not become law curl \u0026quot;https://api.vaquill.ai/api/v1/us/session-laws/list?jurisdiction=mn\u0026amp;updatedSince=2026-10-01\u0026quot; \\ -H \u0026quot;Authorization: Bearer $VAQUILL_API_KEY\u0026quot; curl \u0026quot;https://api.vaquill.ai/api/v1/us/session-laws/list?jurisdiction=mn\u0026amp;isLaw=false\u0026amp;enactmentOutcome=vetoed\u0026amp;enactmentOutcome=pocket_veto\u0026quot; \\ -H \u0026quot;Authorization: Bearer $VAQUILL_API_KEY\u0026quot; # find by words in the title or the printed bill number curl \u0026quot;https://api.vaquill.ai/api/v1/us/session-laws/list?jurisdiction=mn\u0026amp;q=court%20fees\u0026quot; -H \u0026quot;Authorization: Bearer $VAQUILL_API_KEY\u0026quot; ``javascript const url = new URL(\u0026quot;https://api.vaquill.ai/api/v1/us/session-laws/list\u0026quot;); url.search = new URLSearchParams({ jurisdiction: \u0026quot;mn\u0026quot;, session: \u0026quot;2025R\u0026quot; }); const res = await fetch(url, { headers: { Authorization: Bearer ${process.env.VAQUILL_API_KEY} }, }); const { results, nextCursor, hasMore } = await res.json(); ` Related endpoints - GET /us/statutes/resolve answers a citation that names a state session law rather than a code section with a sessionLaw block (matched, or ambiguous with every candidate), pointing here. It never changes resolved or section. - GET /us/statutes/coverage lists, per jurisdiction under sessionLaws, which sessions we hold session laws for and whether each is complete or partial. Read it first: a law missing from a partial session is not evidence that it does not exist. - Federal session laws (the Statutes at Large, SAL_ ids) are not served here. Read them with GET /us/statutes/section/{actId}. Nulls. Every field of a response is always present: one with no value is null (or [] for a list). The examples on this page leave the nulls out for brevity. The exceptions are blocks that exist only when they apply and are OMITTED otherwise, never null: publisher, provenance and session.coverageStatus on a law, and coverage on a list page that has rows. Rate limits. Calls count against your key\u0026#x27;s per-minute budget like every Data API route; a 429 carries Retry-After`.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Vaquill AI\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/vaquill/cxXYvhk1ARjGdjCs/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/vaquill/cxXYvhk1ARjGdjCs/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/vaquill/cxXYvhk1ARjGdjCs/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/vaquill/cxXYvhk1ARjGdjCs/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/vaquill/cxXYvhk1ARjGdjCs/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/vaquill/cxXYvhk1ARjGdjCs/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/vaquill/cxXYvhk1ARjGdjCs/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/vaquill/cxXYvhk1ARjGdjCs/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/vaquill/cxXYvhk1ARjGdjCs/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"List a state\u0026#x27;s session laws - Vaquill AI\">\u003cmeta data-mint-head property=\"og:description\" content=\"List the session laws of one state: every act its legislature enacted, filtered by session, approval date or effective date. This is how you ask \u0026quot;what became law in Texas this session\u0026quot;, \u0026quot;what was signed in April\u0026quot; or \u0026quot;what takes effect on September 1, 2025\u0026quot;, and how you turn the answer into sessionLawIds for the get and body endpoints. A session law is the act as enacted, before it is folded into a code; v1 serves STATE acts. Cost: 1 credit per page of up to 200 rows (default 50), however many rows the page holds. An empty page is an answer and is charged when it means nothing matches your filters. A request that fails validation (422) is never charged; a failure on our side (500, 503) is refunded. Empty pages. A page with no rows carries coverage, what we hold of the session you named (or of the state, when you named none), so you can tell \u0026quot;nothing matches\u0026quot; from \u0026quot;we have not collected this\u0026quot;. coverage.status is complete (we hold every law the publisher lists for it: the empty page is a true negative, and it is charged), partial (the collection stopped short, so the law you want may exist) or not_held (we hold nothing of it). On partial and not_held the page is NOT charged and creditsConsumed is 0: we do not bill an empty answer that may be our gap. The one exception is a request that names only the state, where some sessions we hold are complete and some partial: the page is charged, since for the complete ones it is a true negative, and coverage.partialSessions names the sessions to doubt (send one as session to ask about it alone). If coverage cannot be read the page is charged as before and coverage is omitted. Filters. jurisdiction is required and scopes everything; the rest narrow it and combine with AND. A value that is malformed is a 422, and so is a range whose end is before its start (approvedTo before approvedFrom, effectiveTo before effectiveFrom). A value that is well formed and matches nothing (an unknown session, a date range with no laws) is a 200 with results: []. Dates are YYYY-MM-DD. - Everything from one session: session (2025R, 2025S1). - Approved in a window: approvedFrom / approvedTo. - Taking effect in a window: effectiveFrom / effectiveTo. For one day send the same date to both. This matches laws whose first-to-last effective dates overlap your window, so read effectiveFirst and effectiveLast on each row and effectiveDates on the law. A law with no held effective date (not every state prints them) never matches. - Narrow by series, instrumentType, hasText or textStatus. - What became law and what did not: isLaw (false for the vetoed and pocket-vetoed measures; a measure whose outcome does not settle it has a null isLaw and matches neither value) and enactmentOutcome, repeated for several outcomes (enactmentOutcome=vetoed\u0026amp;enactmentOutcome=pocket_veto). - A sync job: updatedSince returns the laws whose record changed on or after a date (midnight UTC, by updatedAt), so a job that stores its last run pulls only what is new or corrected. - Find by words: q, a case-insensitive substring of the title or the bill number as the publisher prints it (3 to 100 characters). It is a substring match inside one state, not a search engine. - A derived approval date (approvedDateDerived: true) is not matched by approvedFrom and approvedTo, which read the registry\u0026#x27;s own approval date. Paging. Rows come in session.code order, then sessionLawId, both as TEXT in the database\u0026#x27;s collation, not in chapter order: ..._C10 sorts before ..._C2, and the id\u0026#x27;s series and numbering-year segments sort before the chapter. Sort client-side by number if you need chapter order. The order is the same on every page and for every filter, so a cursor never skips or repeats a row. Send nextCursor back as cursor, with the same filters, while hasMore is true (a cursor sent with different filters is a 422, cursor_query_mismatch: restart without it). The cursor is a keyset (it names the last row you saw), so laws added between your calls never repeat or skip a row you have passed. count is the size of this page, never a total. Text. Rows include laws whose text we do not hold (textStatus: not_held) or hold and withhold (withheld, with withheldReason): the row is still a real law. Pass hasText=true for just the laws /{sessionLawId}/body will serve. A row is the summary only: the full dates, sources and code sections are on GET /us/session-laws/{sessionLawId}. Each row carries charCount and estimatedBodyPages, so you can price reading a law before you open it. citableAs is the law cited the way a lawyer writes it (Minn. Laws 2025, ch. 1), and licenseNote says what its licence class permits. Cost of reading a law. Reading a whole law is estimatedBodyPages times the price of one body page (6 credits). Both are on the record: charCount is its length in characters and estimatedBodyPages is that divided by the page size (about 30,000 characters), rounded up, and null unless the text is served. Most acts take a page or two. The longest we hold, Ohio\u0026#x27;s 2025 budget act (HB 96, 9,571,132 characters), takes about 320 pages, 1,920 credits to read in full, so check estimatedBodyPages before you page through an omnibus act. Each body response then carries pagePrice (what that page cost) and estimatedRemainingCredits (the pages still to come times the price) so you can stop whenever you have enough. Example bash curl \u0026quot;https://api.vaquill.ai/api/v1/us/session-laws/list?jurisdiction=tx\u0026amp;effectiveFrom=2025-09-01\u0026amp;effectiveTo=2025-09-01\u0026amp;limit=25\u0026quot; \\ -H \u0026quot;Authorization: Bearer $VAQUILL_API_KEY\u0026quot; # only what changed since your last sync, and only measures that did not become law curl \u0026quot;https://api.vaquill.ai/api/v1/us/session-laws/list?jurisdiction=mn\u0026amp;updatedSince=2026-10-01\u0026quot; \\ -H \u0026quot;Authorization: Bearer $VAQUILL_API_KEY\u0026quot; curl \u0026quot;https://api.vaquill.ai/api/v1/us/session-laws/list?jurisdiction=mn\u0026amp;isLaw=false\u0026amp;enactmentOutcome=vetoed\u0026amp;enactmentOutcome=pocket_veto\u0026quot; \\ -H \u0026quot;Authorization: Bearer $VAQUILL_API_KEY\u0026quot; # find by words in the title or the printed bill number curl \u0026quot;https://api.vaquill.ai/api/v1/us/session-laws/list?jurisdiction=mn\u0026amp;q=court%20fees\u0026quot; -H \u0026quot;Authorization: Bearer $VAQUILL_API_KEY\u0026quot; ``javascript const url = new URL(\u0026quot;https://api.vaquill.ai/api/v1/us/session-laws/list\u0026quot;); url.search = new URLSearchParams({ jurisdiction: \u0026quot;mn\u0026quot;, session: \u0026quot;2025R\u0026quot; }); const res = await fetch(url, { headers: { Authorization: Bearer ${process.env.VAQUILL_API_KEY} }, }); const { results, nextCursor, hasMore } = await res.json(); ` Related endpoints - GET /us/statutes/resolve answers a citation that names a state session law rather than a code section with a sessionLaw block (matched, or ambiguous with every candidate), pointing here. It never changes resolved or section. - GET /us/statutes/coverage lists, per jurisdiction under sessionLaws, which sessions we hold session laws for and whether each is complete or partial. Read it first: a law missing from a partial session is not evidence that it does not exist. - Federal session laws (the Statutes at Large, SAL_ ids) are not served here. Read them with GET /us/statutes/section/{actId}. Nulls. Every field of a response is always present: one with no value is null (or [] for a list). The examples on this page leave the nulls out for brevity. The exceptions are blocks that exist only when they apply and are OMITTED otherwise, never null: publisher, provenance and session.coverageStatus on a law, and coverage on a list page that has rows. Rate limits. Calls count against your key\u0026#x27;s per-minute budget like every Data API route; a 429 carries Retry-After`.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Vaquill AI Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://www.vaquill.ai/docs/api-reference/us-session-laws/list-a-states-session-laws\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://vaquill.mintlify.site/docs/_mintlify/api/og/v2?division=US+Session+Laws\u0026amp;title=List+a+state%27s+session+laws\u0026amp;description=List+the+session+laws+of+one+state%3A+every+act+its+legislature+enacted%2C+filtered%0Aby+session%2C+approval+date+or+effective+date.+This+is+how+you+ask+%22what+became+la\u0026amp;theme=c0fd5b007b30a7a110519c4a\u0026amp;signature=c9970f879dc00680fb7e76c7046bf6670aafebbfc8c92ba8c4409ed9f38213c4\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"List a state\u0026#x27;s session laws - Vaquill AI\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"List the session laws of one state: every act its legislature enacted, filtered by session, approval date or effective date. This is how you ask \u0026quot;what became law in Texas this session\u0026quot;, \u0026quot;what was signed in April\u0026quot; or \u0026quot;what takes effect on September 1, 2025\u0026quot;, and how you turn the answer into sessionLawIds for the get and body endpoints. A session law is the act as enacted, before it is folded into a code; v1 serves STATE acts. Cost: 1 credit per page of up to 200 rows (default 50), however many rows the page holds. An empty page is an answer and is charged when it means nothing matches your filters. A request that fails validation (422) is never charged; a failure on our side (500, 503) is refunded. Empty pages. A page with no rows carries coverage, what we hold of the session you named (or of the state, when you named none), so you can tell \u0026quot;nothing matches\u0026quot; from \u0026quot;we have not collected this\u0026quot;. coverage.status is complete (we hold every law the publisher lists for it: the empty page is a true negative, and it is charged), partial (the collection stopped short, so the law you want may exist) or not_held (we hold nothing of it). On partial and not_held the page is NOT charged and creditsConsumed is 0: we do not bill an empty answer that may be our gap. The one exception is a request that names only the state, where some sessions we hold are complete and some partial: the page is charged, since for the complete ones it is a true negative, and coverage.partialSessions names the sessions to doubt (send one as session to ask about it alone). If coverage cannot be read the page is charged as before and coverage is omitted. Filters. jurisdiction is required and scopes everything; the rest narrow it and combine with AND. A value that is malformed is a 422, and so is a range whose end is before its start (approvedTo before approvedFrom, effectiveTo before effectiveFrom). A value that is well formed and matches nothing (an unknown session, a date range with no laws) is a 200 with results: []. Dates are YYYY-MM-DD. - Everything from one session: session (2025R, 2025S1). - Approved in a window: approvedFrom / approvedTo. - Taking effect in a window: effectiveFrom / effectiveTo. For one day send the same date to both. This matches laws whose first-to-last effective dates overlap your window, so read effectiveFirst and effectiveLast on each row and effectiveDates on the law. A law with no held effective date (not every state prints them) never matches. - Narrow by series, instrumentType, hasText or textStatus. - What became law and what did not: isLaw (false for the vetoed and pocket-vetoed measures; a measure whose outcome does not settle it has a null isLaw and matches neither value) and enactmentOutcome, repeated for several outcomes (enactmentOutcome=vetoed\u0026amp;enactmentOutcome=pocket_veto). - A sync job: updatedSince returns the laws whose record changed on or after a date (midnight UTC, by updatedAt), so a job that stores its last run pulls only what is new or corrected. - Find by words: q, a case-insensitive substring of the title or the bill number as the publisher prints it (3 to 100 characters). It is a substring match inside one state, not a search engine. - A derived approval date (approvedDateDerived: true) is not matched by approvedFrom and approvedTo, which read the registry\u0026#x27;s own approval date. Paging. Rows come in session.code order, then sessionLawId, both as TEXT in the database\u0026#x27;s collation, not in chapter order: ..._C10 sorts before ..._C2, and the id\u0026#x27;s series and numbering-year segments sort before the chapter. Sort client-side by number if you need chapter order. The order is the same on every page and for every filter, so a cursor never skips or repeats a row. Send nextCursor back as cursor, with the same filters, while hasMore is true (a cursor sent with different filters is a 422, cursor_query_mismatch: restart without it). The cursor is a keyset (it names the last row you saw), so laws added between your calls never repeat or skip a row you have passed. count is the size of this page, never a total. Text. Rows include laws whose text we do not hold (textStatus: not_held) or hold and withhold (withheld, with withheldReason): the row is still a real law. Pass hasText=true for just the laws /{sessionLawId}/body will serve. A row is the summary only: the full dates, sources and code sections are on GET /us/session-laws/{sessionLawId}. Each row carries charCount and estimatedBodyPages, so you can price reading a law before you open it. citableAs is the law cited the way a lawyer writes it (Minn. Laws 2025, ch. 1), and licenseNote says what its licence class permits. Cost of reading a law. Reading a whole law is estimatedBodyPages times the price of one body page (6 credits). Both are on the record: charCount is its length in characters and estimatedBodyPages is that divided by the page size (about 30,000 characters), rounded up, and null unless the text is served. Most acts take a page or two. The longest we hold, Ohio\u0026#x27;s 2025 budget act (HB 96, 9,571,132 characters), takes about 320 pages, 1,920 credits to read in full, so check estimatedBodyPages before you page through an omnibus act. Each body response then carries pagePrice (what that page cost) and estimatedRemainingCredits (the pages still to come times the price) so you can stop whenever you have enough. Example bash curl \u0026quot;https://api.vaquill.ai/api/v1/us/session-laws/list?jurisdiction=tx\u0026amp;effectiveFrom=2025-09-01\u0026amp;effectiveTo=2025-09-01\u0026amp;limit=25\u0026quot; \\ -H \u0026quot;Authorization: Bearer $VAQUILL_API_KEY\u0026quot; # only what changed since your last sync, and only measures that did not become law curl \u0026quot;https://api.vaquill.ai/api/v1/us/session-laws/list?jurisdiction=mn\u0026amp;updatedSince=2026-10-01\u0026quot; \\ -H \u0026quot;Authorization: Bearer $VAQUILL_API_KEY\u0026quot; curl \u0026quot;https://api.vaquill.ai/api/v1/us/session-laws/list?jurisdiction=mn\u0026amp;isLaw=false\u0026amp;enactmentOutcome=vetoed\u0026amp;enactmentOutcome=pocket_veto\u0026quot; \\ -H \u0026quot;Authorization: Bearer $VAQUILL_API_KEY\u0026quot; # find by words in the title or the printed bill number curl \u0026quot;https://api.vaquill.ai/api/v1/us/session-laws/list?jurisdiction=mn\u0026amp;q=court%20fees\u0026quot; -H \u0026quot;Authorization: Bearer $VAQUILL_API_KEY\u0026quot; ``javascript const url = new URL(\u0026quot;https://api.vaquill.ai/api/v1/us/session-laws/list\u0026quot;); url.search = new URLSearchParams({ jurisdiction: \u0026quot;mn\u0026quot;, session: \u0026quot;2025R\u0026quot; }); const res = await fetch(url, { headers: { Authorization: Bearer ${process.env.VAQUILL_API_KEY} }, }); const { results, nextCursor, hasMore } = await res.json(); ` Related endpoints - GET /us/statutes/resolve answers a citation that names a state session law rather than a code section with a sessionLaw block (matched, or ambiguous with every candidate), pointing here. It never changes resolved or section. - GET /us/statutes/coverage lists, per jurisdiction under sessionLaws, which sessions we hold session laws for and whether each is complete or partial. Read it first: a law missing from a partial session is not evidence that it does not exist. - Federal session laws (the Statutes at Large, SAL_ ids) are not served here. Read them with GET /us/statutes/section/{actId}. Nulls. Every field of a response is always present: one with no value is null (or [] for a list). The examples on this page leave the nulls out for brevity. The exceptions are blocks that exist only when they apply and are OMITTED otherwise, never null: publisher, provenance and session.coverageStatus on a law, and coverage on a list page that has rows. Rate limits. Calls count against your key\u0026#x27;s per-minute budget like every Data API route; a 429 carries Retry-After`.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://vaquill.mintlify.site/docs/_mintlify/api/og/v2?division=US+Session+Laws\u0026amp;title=List+a+state%27s+session+laws\u0026amp;description=List+the+session+laws+of+one+state%3A+every+act+its+legislature+enacted%2C+filtered%0Aby+session%2C+approval+date+or+effective+date.+This+is+how+you+ask+%22what+became+la\u0026amp;theme=c0fd5b007b30a7a110519c4a\u0026amp;signature=c9970f879dc00680fb7e76c7046bf6670aafebbfc8c92ba8c4409ed9f38213c4\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/vaquill/cxXYvhk1ARjGdjCs/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Vaquill AI\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6E3730\">\u003cmeta data-mint-head name=\"og:locale\" content=\"en_US\">\u003clink data-mint-head rel=\"canonical\" href=\"https://www.vaquill.ai/docs/api-reference/us-session-laws/list-a-states-session-laws\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/us-session-laws/list-a-states-session-laws.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.vaquill.ai/#organization\",\"name\":\"Vaquill AI\",\"url\":\"https://www.vaquill.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/vaquill/HoYf91pjRoTl4-t3/logo/light.png?fit=max\u0026auto=format\u0026n=HoYf91pjRoTl4-t3\u0026q=85\u0026s=1c97b6018caaa1fee0a743b05651bb81\"}},{\"@type\":\"WebSite\",\"@id\":\"https://www.vaquill.ai/docs#website\",\"name\":\"Vaquill AI\",\"url\":\"https://www.vaquill.ai/docs\",\"publisher\":{\"@id\":\"https://www.vaquill.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://www.vaquill.ai/docs/api-reference/us-session-laws/list-a-states-session-laws#webpage\",\"url\":\"https://www.vaquill.ai/docs/api-reference/us-session-laws/list-a-states-session-laws\",\"name\":\"List a state's session laws\",\"description\":\"List the session laws of one state: every act its legislature enacted, filtered by session, approval date or effective date. This is how you ask \\\"what became law in Texas this session\\\", \\\"what was signed in April\\\" or \\\"what takes effect on September 1, 2025\\\", and how you turn the answer into sessionLawIds for the get and body endpoints. A session law is the act as enacted, before it is folded into a code; v1 serves STATE acts. Cost: 1 credit per page of up to 200 rows (default 50), however many rows the page holds. An empty page is an answer and is charged when it means nothing matches your filters. A request that fails validation (422) is never charged; a failure on our side (500, 503) is refunded. Empty pages. A page with no rows carries coverage, what we hold of the session you named (or of the state, when you named none), so you can tell \\\"nothing matches\\\" from \\\"we have not collected this\\\". coverage.status is complete (we hold every law the publisher lists for it: the empty page is a true negative, and it is charged), partial (the collection stopped short, so the law you want may exist) or not_held (we hold nothing of it). On partial and not_held the page is NOT charged and creditsConsumed is 0: we do not bill an empty answer that may be our gap. The one exception is a request that names only the state, where some sessions we hold are complete and some partial: the page is charged, since for the complete ones it is a true negative, and coverage.partialSessions names the sessions to doubt (send one as session to ask about it alone). If coverage cannot be read the page is charged as before and coverage is omitted. Filters. jurisdiction is required and scopes everything; the rest narrow it and combine with AND. A value that is malformed is a 422, and so is a range whose end is before its start (approvedTo before approvedFrom, effectiveTo before effectiveFrom). A value that is well formed and matches nothing (an unknown session, a date range with no laws) is a 200 with results: []. Dates are YYYY-MM-DD. - Everything from one session: session (2025R, 2025S1). - Approved in a window: approvedFrom / approvedTo. - Taking effect in a window: effectiveFrom / effectiveTo. For one day send the same date to both. This matches laws whose first-to-last effective dates overlap your window, so read effectiveFirst and effectiveLast on each row and effectiveDates on the law. A law with no held effective date (not every state prints them) never matches. - Narrow by series, instrumentType, hasText or textStatus. - What became law and what did not: isLaw (false for the vetoed and pocket-vetoed measures; a measure whose outcome does not settle it has a null isLaw and matches neither value) and enactmentOutcome, repeated for several outcomes (enactmentOutcome=vetoed\u0026enactmentOutcome=pocket_veto). - A sync job: updatedSince returns the laws whose record changed on or after a date (midnight UTC, by updatedAt), so a job that stores its last run pulls only what is new or corrected. - Find by words: q, a case-insensitive substring of the title or the bill number as the publisher prints it (3 to 100 characters). It is a substring match inside one state, not a search engine. - A derived approval date (approvedDateDerived: true) is not matched by approvedFrom and approvedTo, which read the registry's own approval date. Paging. Rows come in session.code order, then sessionLawId, both as TEXT in the database's collation, not in chapter order: ..._C10 sorts before ..._C2, and the id's series and numbering-year segments sort before the chapter. Sort client-side by number if you need chapter order. The order is the same on every page and for every filter, so a cursor never skips or repeats a row. Send nextCursor back as cursor, with the same filters, while hasMore is true (a cursor sent with different filters is a 422, cursor_query_mismatch: restart without it). The cursor is a keyset (it names the last row you saw), so laws added between your calls never repeat or skip a row you have passed. count is the size of this page, never a total. Text. Rows include laws whose text we do not hold (textStatus: not_held) or hold and withhold (withheld, with withheldReason): the row is still a real law. Pass hasText=true for just the laws /{sessionLawId}/body will serve. A row is the summary only: the full dates, sources and code sections are on GET /us/session-laws/{sessionLawId}. Each row carries charCount and estimatedBodyPages, so you can price reading a law before you open it. citableAs is the law cited the way a lawyer writes it (Minn. Laws 2025, ch. 1), and licenseNote says what its licence class permits. Cost of reading a law. Reading a whole law is estimatedBodyPages times the price of one body page (6 credits). Both are on the record: charCount is its length in characters and estimatedBodyPages is that divided by the page size (about 30,000 characters), rounded up, and null unless the text is served. Most acts take a page or two. The longest we hold, Ohio's 2025 budget act (HB 96, 9,571,132 characters), takes about 320 pages, 1,920 credits to read in full, so check estimatedBodyPages before you page through an omnibus act. Each body response then carries pagePrice (what that page cost) and estimatedRemainingCredits (the pages still to come times the price) so you can stop whenever you have enough. Example bash curl \\\"https://api.vaquill.ai/api/v1/us/session-laws/list?jurisdiction=tx\u0026effectiveFrom=2025-09-01\u0026effectiveTo=2025-09-01\u0026limit=25\\\" \\\\ -H \\\"Authorization: Bearer $VAQUILL_API_KEY\\\" # only what changed since your last sync, and only measures that did not become law curl \\\"https://api.vaquill.ai/api/v1/us/session-laws/list?jurisdiction=mn\u0026updatedSince=2026-10-01\\\" \\\\ -H \\\"Authorization: Bearer $VAQUILL_API_KEY\\\" curl \\\"https://api.vaquill.ai/api/v1/us/session-laws/list?jurisdiction=mn\u0026isLaw=false\u0026enactmentOutcome=vetoed\u0026enactmentOutcome=pocket_veto\\\" \\\\ -H \\\"Authorization: Bearer $VAQUILL_API_KEY\\\" # find by words in the title or the printed bill number curl \\\"https://api.vaquill.ai/api/v1/us/session-laws/list?jurisdiction=mn\u0026q=court%20fees\\\" -H \\\"Authorization: Bearer $VAQUILL_API_KEY\\\" ``javascript const url = new URL(\\\"https://api.vaquill.ai/api/v1/us/session-laws/list\\\"); url.search = new URLSearchParams({ jurisdiction: \\\"mn\\\", session: \\\"2025R\\\" }); const res = await fetch(url, { headers: { Authorization: Bearer ${process.env.VAQUILL_API_KEY} }, }); const { results, nextCursor, hasMore } = await res.json(); ` Related endpoints - GET /us/statutes/resolve answers a citation that names a state session law rather than a code section with a sessionLaw block (matched, or ambiguous with every candidate), pointing here. It never changes resolved or section. - GET /us/statutes/coverage lists, per jurisdiction under sessionLaws, which sessions we hold session laws for and whether each is complete or partial. Read it first: a law missing from a partial session is not evidence that it does not exist. - Federal session laws (the Statutes at Large, SAL_ ids) are not served here. Read them with GET /us/statutes/section/{actId}. Nulls. Every field of a response is always present: one with no value is null (or [] for a list). The examples on this page leave the nulls out for brevity. The exceptions are blocks that exist only when they apply and are OMITTED otherwise, never null: publisher, provenance and session.coverageStatus on a law, and coverage on a list page that has rows. Rate limits. Calls count against your key's per-minute budget like every Data API route; a 429 carries Retry-After`.\",\"isPartOf\":{\"@id\":\"https://www.vaquill.ai/docs#website\"},\"breadcrumb\":{\"@id\":\"https://www.vaquill.ai/docs/api-reference/us-session-laws/list-a-states-session-laws#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.vaquill.ai/docs/api-reference/us-session-laws/list-a-states-session-laws#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"US Session Laws\",\"item\":\"https://www.vaquill.ai/docs/api-reference/us-session-laws/feed-of-changes-to-the-session-law-registry\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"List a state's session laws\",\"item\":\"https://www.vaquill.ai/docs/api-reference/us-session-laws/list-a-states-session-laws\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://www.vaquill.ai/docs/api-reference/us-session-laws/list-a-states-session-laws#apireference\",\"headline\":\"List a state's session laws\",\"name\":\"List a state's session laws\",\"description\":\"List the session laws of one state: every act its legislature enacted, filtered by session, approval date or effective date. This is how you ask \\\"what became law in Texas this session\\\", \\\"what was signed in April\\\" or \\\"what takes effect on September 1, 2025\\\", and how you turn the answer into sessionLawIds for the get and body endpoints. A session law is the act as enacted, before it is folded into a code; v1 serves STATE acts. Cost: 1 credit per page of up to 200 rows (default 50), however many rows the page holds. An empty page is an answer and is charged when it means nothing matches your filters. A request that fails validation (422) is never charged; a failure on our side (500, 503) is refunded. Empty pages. A page with no rows carries coverage, what we hold of the session you named (or of the state, when you named none), so you can tell \\\"nothing matches\\\" from \\\"we have not collected this\\\". coverage.status is complete (we hold every law the publisher lists for it: the empty page is a true negative, and it is charged), partial (the collection stopped short, so the law you want may exist) or not_held (we hold nothing of it). On partial and not_held the page is NOT charged and creditsConsumed is 0: we do not bill an empty answer that may be our gap. The one exception is a request that names only the state, where some sessions we hold are complete and some partial: the page is charged, since for the complete ones it is a true negative, and coverage.partialSessions names the sessions to doubt (send one as session to ask about it alone). If coverage cannot be read the page is charged as before and coverage is omitted. Filters. jurisdiction is required and scopes everything; the rest narrow it and combine with AND. A value that is malformed is a 422, and so is a range whose end is before its start (approvedTo before approvedFrom, effectiveTo before effectiveFrom). A value that is well formed and matches nothing (an unknown session, a date range with no laws) is a 200 with results: []. Dates are YYYY-MM-DD. - Everything from one session: session (2025R, 2025S1). - Approved in a window: approvedFrom / approvedTo. - Taking effect in a window: effectiveFrom / effectiveTo. For one day send the same date to both. This matches laws whose first-to-last effective dates overlap your window, so read effectiveFirst and effectiveLast on each row and effectiveDates on the law. A law with no held effective date (not every state prints them) never matches. - Narrow by series, instrumentType, hasText or textStatus. - What became law and what did not: isLaw (false for the vetoed and pocket-vetoed measures; a measure whose outcome does not settle it has a null isLaw and matches neither value) and enactmentOutcome, repeated for several outcomes (enactmentOutcome=vetoed\u0026enactmentOutcome=pocket_veto). - A sync job: updatedSince returns the laws whose record changed on or after a date (midnight UTC, by updatedAt), so a job that stores its last run pulls only what is new or corrected. - Find by words: q, a case-insensitive substring of the title or the bill number as the publisher prints it (3 to 100 characters). It is a substring match inside one state, not a search engine. - A derived approval date (approvedDateDerived: true) is not matched by approvedFrom and approvedTo, which read the registry's own approval date. Paging. Rows come in session.code order, then sessionLawId, both as TEXT in the database's collation, not in chapter order: ..._C10 sorts before ..._C2, and the id's series and numbering-year segments sort before the chapter. Sort client-side by number if you need chapter order. The order is the same on every page and for every filter, so a cursor never skips or repeats a row. Send nextCursor back as cursor, with the same filters, while hasMore is true (a cursor sent with different filters is a 422, cursor_query_mismatch: restart without it). The cursor is a keyset (it names the last row you saw), so laws added between your calls never repeat or skip a row you have passed. count is the size of this page, never a total. Text. Rows include laws whose text we do not hold (textStatus: not_held) or hold and withhold (withheld, with withheldReason): the row is still a real law. Pass hasText=true for just the laws /{sessionLawId}/body will serve. A row is the summary only: the full dates, sources and code sections are on GET /us/session-laws/{sessionLawId}. Each row carries charCount and estimatedBodyPages, so you can price reading a law before you open it. citableAs is the law cited the way a lawyer writes it (Minn. Laws 2025, ch. 1), and licenseNote says what its licence class permits. Cost of reading a law. Reading a whole law is estimatedBodyPages times the price of one body page (6 credits). Both are on the record: charCount is its length in characters and estimatedBodyPages is that divided by the page size (about 30,000 characters), rounded up, and null unless the text is served. Most acts take a page or two. The longest we hold, Ohio's 2025 budget act (HB 96, 9,571,132 characters), takes about 320 pages, 1,920 credits to read in full, so check estimatedBodyPages before you page through an omnibus act. Each body response then carries pagePrice (what that page cost) and estimatedRemainingCredits (the pages still to come times the price) so you can stop whenever you have enough. Example bash curl \\\"https://api.vaquill.ai/api/v1/us/session-laws/list?jurisdiction=tx\u0026effectiveFrom=2025-09-01\u0026effectiveTo=2025-09-01\u0026limit=25\\\" \\\\ -H \\\"Authorization: Bearer $VAQUILL_API_KEY\\\" # only what changed since your last sync, and only measures that did not become law curl \\\"https://api.vaquill.ai/api/v1/us/session-laws/list?jurisdiction=mn\u0026updatedSince=2026-10-01\\\" \\\\ -H \\\"Authorization: Bearer $VAQUILL_API_KEY\\\" curl \\\"https://api.vaquill.ai/api/v1/us/session-laws/list?jurisdiction=mn\u0026isLaw=false\u0026enactmentOutcome=vetoed\u0026enactmentOutcome=pocket_veto\\\" \\\\ -H \\\"Authorization: Bearer $VAQUILL_API_KEY\\\" # find by words in the title or the printed bill number curl \\\"https://api.vaquill.ai/api/v1/us/session-laws/list?jurisdiction=mn\u0026q=court%20fees\\\" -H \\\"Authorization: Bearer $VAQUILL_API_KEY\\\" ``javascript const url = new URL(\\\"https://api.vaquill.ai/api/v1/us/session-laws/list\\\"); url.search = new URLSearchParams({ jurisdiction: \\\"mn\\\", session: \\\"2025R\\\" }); const res = await fetch(url, { headers: { Authorization: Bearer ${process.env.VAQUILL_API_KEY} }, }); const { results, nextCursor, hasMore } = await res.json(); ` Related endpoints - GET /us/statutes/resolve answers a citation that names a state session law rather than a code section with a sessionLaw block (matched, or ambiguous with every candidate), pointing here. It never changes resolved or section. - GET /us/statutes/coverage lists, per jurisdiction under sessionLaws, which sessions we hold session laws for and whether each is complete or partial. Read it first: a law missing from a partial session is not evidence that it does not exist. - Federal session laws (the Statutes at Large, SAL_ ids) are not served here. Read them with GET /us/statutes/section/{actId}. Nulls. Every field of a response is always present: one with no value is null (or [] for a list). The examples on this page leave the nulls out for brevity. The exceptions are blocks that exist only when they apply and are OMITTED otherwise, never null: publisher, provenance and session.coverageStatus on a law, and coverage on a list page that has rows. Rate limits. Calls count against your key's per-minute budget like every Data API route; a 429 carries Retry-After`.\",\"url\":\"https://www.vaquill.ai/docs/api-reference/us-session-laws/list-a-states-session-laws\",\"mainEntityOfPage\":{\"@id\":\"https://www.vaquill.ai/docs/api-reference/us-session-laws/list-a-states-session-laws#webpage\"},\"publisher\":{\"@id\":\"https://www.vaquill.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://www.vaquill.ai/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Vaquill AI\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Vaquill AI","nav":{"global":{"anchors":[{"anchor":"Changelog","icon":"clock","href":"/api-guide/changelog"},{"anchor":"MCP","icon":"plug","href":"/integrations/mcp/vaquill"}]},"tabs":[{"tab":"Guide","pages":[{"title":"Guide","href":"/api-guide/coverage"}]},{"tab":"US API reference","groups":[{"group":"US Statutes","pages":[{"title":"Search US statutes, constitutions, court rules, and executive actions","deprecated":null,"version":null,"openapi":"https://api.vaquill.ai/external/openapi.json post /api/v1/us/statutes/search","href":"/api-reference/us-statutes/search-us-statutes-constitutions-court-rules-and-executive-actions"},{"title":"Get statute section metadata","deprecated":null,"version":null,"openapi":"https://api.vaquill.ai/external/openapi.json get /api/v1/us/statutes/section/{act_id}","href":"/api-reference/us-statutes/get-statute-section-metadata"},{"title":"Resolve a citation to its section","deprecated":null,"version":null,"openapi":"https://api.vaquill.ai/external/openapi.json get /api/v1/us/statutes/resolve","href":"/api-reference/us-statutes/resolve-a-citation-to-its-section"},{"title":"Resolve many citations at once","deprecated":null,"version":null,"openapi":"https://api.vaquill.ai/external/openapi.json post /api/v1/us/statutes/resolve","href":"/api-reference/us-statutes/resolve-many-citations-at-once"},{"title":"Get the sections around this one","deprecated":null,"version":null,"openapi":"https://api.vaquill.ai/external/openapi.json get /api/v1/us/statutes/section/{act_id}/related","href":"/api-reference/us-statutes/get-the-sections-around-this-one"},{"title":"Get metadata for many statute sections","deprecated":null,"version":null,"openapi":"https://api.vaquill.ai/external/openapi.json post /api/v1/us/statutes/sections","href":"/api-reference/us-statutes/get-metadata-for-many-statute-sections"},{"title":"Get statute full text","deprecated":null,"version":null,"openapi":"https://api.vaquill.ai/external/openapi.json get /api/v1/us/statutes/section/{act_id}/body","href":"/api-reference/us-statutes/get-statute-full-text"},{"title":"Count the sections in a scope","deprecated":null,"version":null,"openapi":"https://api.vaquill.ai/external/openapi.json post /api/v1/us/statutes/count","href":"/api-reference/us-statutes/count-the-sections-in-a-scope"},{"title":"Coverage matrix by jurisdiction and corpusType","deprecated":null,"version":null,"openapi":"https://api.vaquill.ai/external/openapi.json get /api/v1/us/statutes/coverage","href":"/api-reference/us-statutes/coverage-matrix-by-jurisdiction-and-corpustype"},{"title":"Browse the statutory hierarchy","deprecated":null,"version":null,"openapi":"https://api.vaquill.ai/external/openapi.json get /api/v1/us/statutes/divisions","href":"/api-reference/us-statutes/browse-the-statutory-hierarchy"},{"title":"Get this section's change history","deprecated":null,"version":null,"openapi":"https://api.vaquill.ai/external/openapi.json get /api/v1/us/statutes/section/{act_id}/changes","href":"/api-reference/us-statutes/get-this-sections-change-history"},{"title":"Which acts a state publisher lists against this section","deprecated":null,"version":null,"openapi":"https://api.vaquill.ai/external/openapi.json get /api/v1/us/statutes/section/{act_id}/enactments","href":"/api-reference/us-statutes/which-acts-a-state-publisher-lists-against-this-section"},{"title":"Get the Federal Register documents behind a CFR section","deprecated":null,"version":null,"openapi":"https://api.vaquill.ai/external/openapi.json get /api/v1/us/statutes/section/{act_id}/rulemaking","href":"/api-reference/us-statutes/get-the-federal-register-documents-behind-a-cfr-section"},{"title":"Get every Federal Register document for a CFR part","deprecated":null,"version":null,"openapi":"https://api.vaquill.ai/external/openapi.json get /api/v1/us/statutes/part/{title}/{part}/rulemaking","href":"/api-reference/us-statutes/get-every-federal-register-document-for-a-cfr-part"},{"title":"Find the citations in a text and resolve each","deprecated":null,"version":null,"openapi":"https://api.vaquill.ai/external/openapi.json post /api/v1/us/statutes/extract-citations","href":"/api-reference/us-statutes/find-the-citations-in-a-text-and-resolve-each"},{"title":"Find the sections that cite this one","deprecated":null,"version":null,"openapi":"https://api.vaquill.ai/external/openapi.json get /api/v1/us/statutes/section/{act_id}/cited-by","href":"/api-reference/us-statutes/find-the-sections-that-cite-this-one"},{"title":"Get the defined terms that govern this section","deprecated":null,"version":null,"openapi":"https://api.vaquill.ai/external/openapi.json get /api/v1/us/statutes/section/{act_id}/definitions","href":"/api-reference/us-statutes/get-the-defined-terms-that-govern-this-section"},{"title":"Compare this provision against other states","deprecated":null,"version":null,"openapi":"https://api.vaquill.ai/external/openapi.json get /api/v1/us/statutes/section/{act_id}/cross-state","href":"/api-reference/us-statutes/compare-this-provision-against-other-states"}]},{"group":"Pricing","pages":[{"title":"Get API credit pricing","deprecated":null,"version":null,"openapi":"https://api.vaquill.ai/external/openapi.json get /api/v1/api-credits/pricing","href":"/api-reference/pricing/get-api-credit-pricing"}]},{"group":"Board Watches","pages":[{"title":"List watchable boards","deprecated":null,"version":null,"openapi":"https://api.vaquill.ai/external/openapi.json get /api/v1/boards","href":"/api-reference/board-watches/list-watchable-boards"},{"title":"List your board watches","deprecated":null,"version":null,"openapi":"https://api.vaquill.ai/external/openapi.json get /api/v1/watches","href":"/api-reference/board-watches/list-your-board-watches"},{"title":"Create a board watch","deprecated":null,"version":null,"openapi":"https://api.vaquill.ai/external/openapi.json post /api/v1/watches","href":"/api-reference/board-watches/create-a-board-watch"},{"title":"Send a test delivery","deprecated":null,"version":null,"openapi":"https://api.vaquill.ai/external/openapi.json post /api/v1/watches/{watch_id}/test","href":"/api-reference/board-watches/send-a-test-delivery"},{"title":"Delete a board watch","deprecated":null,"version":null,"openapi":"https://api.vaquill.ai/external/openapi.json delete /api/v1/watches/{watch_id}","href":"/api-reference/board-watches/delete-a-board-watch"},{"title":"Update a board watch","deprecated":null,"version":null,"openapi":"https://api.vaquill.ai/external/openapi.json patch /api/v1/watches/{watch_id}","href":"/api-reference/board-watches/update-a-board-watch"},{"title":"List what changed on a watch's source","deprecated":null,"version":null,"openapi":"https://api.vaquill.ai/external/openapi.json get /api/v1/watches/{watch_id}/changes","href":"/api-reference/board-watches/list-what-changed-on-a-watchs-source"},{"title":"Old-vs-new text for one change","deprecated":null,"version":null,"openapi":"https://api.vaquill.ai/external/openapi.json get /api/v1/watches/{watch_id}/changes/{change_id}/diff","href":"/api-reference/board-watches/old-vs-new-text-for-one-change"},{"title":"List delivery history for a watch","deprecated":null,"version":null,"openapi":"https://api.vaquill.ai/external/openapi.json get /api/v1/watches/{watch_id}/deliveries","href":"/api-reference/board-watches/list-delivery-history-for-a-watch"},{"title":"Law change alert","version":null,"deprecated":null,"openapi":"https://api.vaquill.ai/external/openapi.json webhook board.updated","href":"/api-reference/board-watches/law-change-alert"},{"title":"Webhook test delivery","version":null,"deprecated":null,"openapi":"https://api.vaquill.ai/external/openapi.json webhook board.test","href":"/api-reference/board-watches/webhook-test-delivery"}]},{"group":"Credits","pages":[{"title":"Get your credit balance","deprecated":null,"version":null,"openapi":"https://api.vaquill.ai/external/openapi.json get /api/v1/credits/balance","href":"/api-reference/credits/get-your-credit-balance"}]},{"group":"US Session Laws","pages":[{"title":"Feed of changes to the session-law registry","deprecated":null,"version":null,"openapi":"https://api.vaquill.ai/external/openapi.json get /api/v1/us/session-laws/changes","href":"/api-reference/us-session-laws/feed-of-changes-to-the-session-law-registry"},{"title":"Get many state session laws at once, by id or citation","deprecated":null,"version":null,"openapi":"https://api.vaquill.ai/external/openapi.json post /api/v1/us/session-laws/batch","href":"/api-reference/us-session-laws/get-many-state-session-laws-at-once-by-id-or-citation"},{"title":"Search the text of state session laws","deprecated":null,"version":null,"openapi":"https://api.vaquill.ai/external/openapi.json post /api/v1/us/session-laws/search","href":"/api-reference/us-session-laws/search-the-text-of-state-session-laws"},{"title":"List every served version of a state session law","description":"Every version of one STATE session law that we served or adopted, newest first, and which of them is\ncurrent. The text of a law can be corrected after we first serve it (a better extraction of the same\nsource, a re-collection), and the version you read yesterday is then not the one a plain call returns\ntoday. This route lists the versions with what identifies each (when we recorded it, its length, its\nhash, how the text was taken) and how its text can be read. It carries no text: read one version's text\nwith `GET /us/session-laws/{sessionLawId}/body?version=N`.\n\n**Cost**: 1 credit per call, however many versions the law has. A law with a single version\nanswers a list of one and is charged: \"this law has never changed\" is the answer you paid for. Reading\na version's text is a separate call at the body price (6 credits per page), the same price as\nreading the current text. A request that fails validation (422) is never charged; a law that is not\nfound (404) is never charged; a failure on our side (500, 503) is refunded.\n\n**Id only.** This route takes a `sessionLawId`, not a citation: resolve a citation once with\n`GET /us/session-laws/{sessionLawId}` and use the id it returns. A federal id (`SAL_...`) is a 404\n(`federal_session_law`), as on `/body`.\n\n**What a version says.** `version` is the number to send as `version` on `/body`. Numbers can have gaps:\na version we recorded and never served or adopted is not listed. Exactly one listed version has\n`isCurrent: true`, and `currentVersion` repeats its number: it is the text a plain `/body` call serves.\n`recordedAt` dates OUR copy of the text, never the act (see `approvedDate` on the law for that).\n`totalChars` and `textSha256` identify the text: two versions with the same hash have the same text, and\nonly the record around it changed. `citation`, `title` and `approvedDate` are as that version recorded\nthem, so a correction that fixed a title shows here.\n\n**How a version's text can be read.** `textAccess` says what reading it takes. `served`: a plain call to\n`/body?version=N` reads it. `includeUnverified`: the law is held back (`textStatus: withheld`) and this\ntext is readable only with `includeUnverified=true`, labelled by `textReliability` and `reasonCode` so\nyou know it may show deleted or vetoed law as if it were enacted. `none`: there is no text to read for\nthis version, or the law's text may not be published (a licence that bars use, or text that failed our\nown validation). The law-level `textStatus`, `textReliability` and `reasonCode` are the same fields, and\nmean the same, as on `/body`. `textReliability` is omitted when no text of the law may be read, and\n`reasonCode` when the law is served and verified.\n\n**Reading an older version.** Send `version=N` to `/body`. The page, its `nextCursor` and `textSha256`\nbelong to that version's text, so a cursor from one version is a 409 on another. To check that nothing\nchanged under you, compare `textSha256` here with the one you read.\n\n**Example**\n\n```bash\ncurl \"https://api.vaquill.ai/api/v1/us/session-laws/SSL_MN_2025S1_G_Y2025_C1/versions\" \\\n -H \"Authorization: Bearer $VAQUILL_API_KEY\"\n\n# then read the first version's text, one page at the body price\ncurl \"https://api.vaquill.ai/api/v1/us/session-laws/SSL_MN_2025S1_G_Y2025_C1/body?version=1\" \\\n -H \"Authorization: Bearer $VAQUILL_API_KEY\"\n```\n\n```javascript\nconst id = \"SSL_MN_2025S1_G_Y2025_C1\";\nconst res = await fetch(`https://api.vaquill.ai/api/v1/us/session-laws/${encodeURIComponent(id)}/versions`, {\n headers: { Authorization: `Bearer ${process.env.VAQUILL_API_KEY}` },\n});\nconst { versions, currentVersion } = await res.json();\nconst older = versions.filter((v) => !v.isCurrent \u0026\u0026 v.textAccess === \"served\");\n```\n\n**Related endpoints**\n\n- `GET /us/session-laws/{sessionLawId}/body` reads the text of the current version, or of the one you\n name with `version`. It also takes `includeUnverified=true` for a law we hold back.\n- `GET /us/session-laws/{sessionLawId}` is the law's record (dates, sources, code sections affected,\n whether its text is held); it always describes the current version.\n- `GET /us/session-laws/changes` is the registry's change feed: a `corrected` entry there is how you\n learn that a copy of a law you hold may be stale, and this route is where you see what changed.\n- `GET /us/statutes/coverage` says which sessions we hold and how complete each is, under each\n jurisdiction's `sessionLaws` block.\n- Federal session laws (the Statutes at Large, `SAL_` ids) are not served here. Read them with\n `GET /us/statutes/section/{actId}`.\n\n**Nulls.** A field of a version with no value (`citation`, `title`, `approvedDate`, `totalChars`,\n`textSha256`, `textMethod`, `amendatoryMarkup`, `markupConvention`) is `null`. `textReliability` and\n`reasonCode` on the law are the exception: they are OMITTED when they do not apply, never null. The\nexamples on this page leave the nulls out for brevity.\n\n**Rate limits.** Calls count against your key's per-minute budget like every Data API route; a 429\ncarries `Retry-After`.","deprecated":null,"version":null,"openapi":"https://api.vaquill.ai/external/openapi.json get /api/v1/us/session-laws/{session_law_id}/versions","href":"/api-reference/us-session-laws/list-every-served-version-of-a-state-session-law"},{"title":"List a state's session laws","deprecated":null,"version":null,"openapi":"https://api.vaquill.ai/external/openapi.json get /api/v1/us/session-laws/list","href":"/api-reference/us-session-laws/list-a-states-session-laws"},{"title":"Get a state session law's text, current or a past version","description":"The act's text exactly as printed, one page of about 30,000 characters at a\ntime, cut at a paragraph break where one is near. Follow `nextCursor` while\n`hasMore` is true; `pageStart` / `pageEnd` / `totalChars` are character offsets\ninto the whole text, and concatenating the pages in order reproduces it.\n\n**Cost**: 6 credits per page served. Read `estimatedBodyPages` on the law first\n(`charCount` divided by about 30,000). A short act is one page; an omnibus act can\nbe many. Each page is charged on its own, so you can stop whenever you have enough.\n`pagePrice` is what this page cost, `totalPages` the estimated pages in all, and\n`estimatedRemainingCredits` the pages still to come times the price.\n\n**Cost of reading a law.** Reading a whole law is `estimatedBodyPages` times the price\nof one body page (6 credits). Both are on the record: `charCount` is its length\nin characters and `estimatedBodyPages` is that divided by the page size (about\n30,000 characters), rounded up, and null unless the text is served. Most acts\ntake a page or two. The longest we hold, Ohio's 2025 budget act (HB 96, 9,571,132\ncharacters), takes about 320 pages, 1,920 credits to read in\nfull, so check `estimatedBodyPages` before you page through an omnibus act. Each body\nresponse then carries `pagePrice` (what that page cost) and `estimatedRemainingCredits`\n(the pages still to come times the price) so you can stop whenever you have enough.\n\n**Where a page starts.** Follow `nextCursor` from the page before, or send `startChar`,\na character offset into the text (0-based, the scale of `pageStart` and `totalChars`),\nto jump straight to a place you know without paging from the start. Send one or the\nother, never both (a 422, uncharged). A `startChar` page costs and sizes the same as any\nother, and returns a normal signed `nextCursor`. `startChar` has no version binding of\nits own, so add `expectTextSha256` (the `textSha256` you read the text under, in\nlowercase hex, 16 characters or more): if the text was re-collected since, the answer is\na 409 and nothing is charged. A `startChar` at or beyond the end is a 422, refunded.\nThere is no page-size parameter: a page is always about 30,000 characters, so\nits price is fixed.\n\n**Attribution.** Every outcome carries `citation`, `jurisdiction`, `session`,\n`approvedDate` and `sourceUrl`, so a page is attributable on its own. `sourceUrl` is the\nofficial copy on a government host and is present when the text is withheld or not held,\nso a reader always has somewhere to go.\n\n**Id only.** This route takes a `sessionLawId`, not a citation: resolve a citation\nonce with `GET /us/session-laws/{sessionLawId}` and use the id it returns.\n\n**Not served, not charged.** When we do not serve the text (`textStatus` is not\n`held`), the answer is a 200 with `available: false` and a `reason` (`not_held`,\n`withheld`, `pending` or `empty_text`), `creditsConsumed: 0`, the\n`withheldReason` for a withheld law, and the official `sourceUrl`. A federal id (`SAL_...`) is a 404\n(`federal_session_law`); read federal session laws with\n`GET /us/statutes/section/{actId}`. An unknown id is a 404; a stale cursor or a mismatched `expectTextSha256` is a 409\n(start again without `cursor`); a malformed or expired cursor, `cursor` with `startChar`,\nor a `startChar` past the end is a 422. None of these is\ncharged, and a failure on our side (500, 503) is refunded.\n\n**Past versions: `version`.** A law's text can be corrected after we first serve it, and we keep every\nversion we served or adopted. List them with `GET /us/session-laws/{sessionLawId}/versions`, then send\none of those numbers as `version` to read that version's text. Omit it for the current version. The\nresponse then names `version` and `isCurrentVersion`, and the page, `nextCursor` and `textSha256` belong\nto that version, so a cursor from one version is a 409 on another. The price is unchanged: 6\ncredits per page, whichever version you read. A `version` the law does not have is a 404 and is\nrefunded; below 1 is a 422 and never charged. Without `version` (and without `includeUnverified`)\nthe response is exactly what it was before these parameters existed.\n\n**Text we hold back: `includeUnverified`.** A law whose text has a defect we have not cleared is\n`withheld`, and by default `/body` answers `available: false`, free. Send `includeUnverified=true` to\nread its text anyway when the reason it is held back is one we can label. The page then carries\n`textReliability` (`unverified`: a check has not been completed, or `known_issue`: we have evidence of\nthe defect), a stable `reasonCode` and a one-sentence `notice` to show beside the text: the text MAY\nshow deleted (struck) or vetoed law as if it were enacted, so check the printed act at `sourceUrl`\nbefore relying on it. The codes that serve the text, flagged, are `markup_unverified`,\n`strike_unchecked`, `struck_text_shown_as_current`, `struck_text_merged`, `veto_unchecked` and\n`licence_unconfirmed`. Some text is never served, opted in or not: a law whose licence bars use\n(`licence_barred`), text that failed our own validation (`validation_failed`), a session we cannot yet\ntell apart from another (`session_unresolved`), a source we have not yet audited (`collector_unaudited`)\nand a reason we have not classified (`unclassified`).\nThose answer `available: false`, free, with the `reasonCode` and no text. A served law with\n`includeUnverified=true` reads as usual and says `textReliability: verified`. A page you read this way\ncosts 6 credits like any other, and it can be combined with `version`. The fields `version`,\n`isCurrentVersion`, `textReliability`, `reasonCode` and `notice` are OMITTED unless you asked for them.\n\n**Amendatory markup.** An amending act prints the language it deletes and inserts.\nWhere `amendatoryMarkup` is `preserved`, that markup is in `text` in the convention\n`markupConvention` names: `wdiff` writes deleted language `[-like this-]` and\ninserted language `{+like this+}`; `publisher_literal` keeps the publisher's own\nmarkers as printed (Minnesota's `new text begin` and `deleted text begin`); `mixed`\nhas both. Where it is `lost`, the publisher printed markup our text does not keep,\nso deleted words can read as law: check the source before quoting. Only the as\nprinted text is served; there is no clean \"as enacted\" view.\n\n**Example**\n\n```bash\ncurl \"https://api.vaquill.ai/api/v1/us/session-laws/SSL_MN_2025S1_G_Y2025_C1/body\" \\\n -H \"Authorization: Bearer $VAQUILL_API_KEY\"\n\n# jump to a character offset, pinned to the version of the text you read\ncurl \"https://api.vaquill.ai/api/v1/us/session-laws/SSL_MN_2025S1_G_Y2025_C1/body?startChar=29987\u0026expectTextSha256=02693d5b55d4709b\" \\\n -H \"Authorization: Bearer $VAQUILL_API_KEY\"\n\n# an older version of the text (list the versions first)\ncurl \"https://api.vaquill.ai/api/v1/us/session-laws/SSL_MN_2025S1_G_Y2025_C1/versions\" \\\n -H \"Authorization: Bearer $VAQUILL_API_KEY\"\ncurl \"https://api.vaquill.ai/api/v1/us/session-laws/SSL_MN_2025S1_G_Y2025_C1/body?version=1\" \\\n -H \"Authorization: Bearer $VAQUILL_API_KEY\"\n\n# the text of a law we hold back, labelled with how far to trust it\ncurl \"https://api.vaquill.ai/api/v1/us/session-laws/SSL_LA_2025R_G_C2/body?includeUnverified=true\" \\\n -H \"Authorization: Bearer $VAQUILL_API_KEY\"\n```\n\n```javascript\nconst MY_BUDGET = 100; // the most you will spend to finish reading, in credits\nlet cursor;\nlet text = \"\";\ndo {\n const url = new URL(\"https://api.vaquill.ai/api/v1/us/session-laws/SSL_MN_2025S1_G_Y2025_C1/body\");\n if (cursor) url.searchParams.set(\"cursor\", cursor);\n const res = await fetch(url, {\n headers: { Authorization: `Bearer ${process.env.VAQUILL_API_KEY}` },\n });\n const page = await res.json();\n if (!page.available) break; // withheld or not held: page.sourceUrl is the official copy\n text += page.text;\n if (page.estimatedRemainingCredits > MY_BUDGET) break; // stop whenever you have enough\n cursor = page.nextCursor;\n} while (cursor);\n```\n\n**Related endpoints**\n\n- `GET /us/statutes/resolve` answers a citation that names a state session law\n rather than a code section with a `sessionLaw` block (`matched`, or `ambiguous`\n with every candidate), pointing here. It never changes `resolved` or `section`.\n- `GET /us/statutes/coverage` lists, per jurisdiction under `sessionLaws`, which\n sessions we hold session laws for and whether each is `complete` or `partial`.\n Read it first: a law missing from a `partial` session is not evidence that it\n does not exist.\n- Federal session laws (the Statutes at Large, `SAL_` ids) are not served here. Read\n them with `GET /us/statutes/section/{actId}`.\n\n**Nulls.** Every field of a response is always present: one with no value is `null`\n(or `[]` for a list). The examples on this page leave the nulls out for brevity. The\nexceptions are blocks that exist only when they apply and are OMITTED otherwise, never\nnull: `publisher`, `provenance` and `session.coverageStatus` on a law, and `coverage` on a\nlist page that has rows.\n\n**Rate limits.** Calls count against your key's per-minute budget like every Data\nAPI route; a 429 carries `Retry-After`.","deprecated":null,"version":null,"openapi":"https://api.vaquill.ai/external/openapi.json get /api/v1/us/session-laws/{session_law_id}/body","href":"/api-reference/us-session-laws/get-a-state-session-laws-text-current-or-a-past-version"},{"title":"Get a state session law, by id or by citation","deprecated":null,"version":null,"openapi":"https://api.vaquill.ai/external/openapi.json get /api/v1/us/session-laws/{session_law_id}","href":"/api-reference/us-session-laws/get-a-state-session-law-by-id-or-by-citation"}]},{"group":"US Rulemaking","pages":[{"title":"What the rulemaking store holds (free)","deprecated":null,"version":null,"openapi":"https://api.vaquill.ai/external/openapi.json get /api/v1/us/rulemaking/coverage","href":"/api-reference/us-rulemaking/what-the-rulemaking-store-holds-free"},{"title":"List and filter Regulations.gov dockets","deprecated":null,"version":null,"openapi":"https://api.vaquill.ai/external/openapi.json get /api/v1/us/rulemaking/dockets/list","href":"/api-reference/us-rulemaking/list-and-filter-regulationsgov-dockets"},{"title":"One Regulations.gov docket","deprecated":null,"version":null,"openapi":"https://api.vaquill.ai/external/openapi.json get /api/v1/us/rulemaking/dockets/{docket_id}","href":"/api-reference/us-rulemaking/one-regulationsgov-docket"},{"title":"Documents of one docket, oldest first","deprecated":null,"version":null,"openapi":"https://api.vaquill.ai/external/openapi.json get /api/v1/us/rulemaking/dockets/{docket_id}/documents","href":"/api-reference/us-rulemaking/documents-of-one-docket-oldest-first"},{"title":"Everything we hold for one RIN","deprecated":null,"version":null,"openapi":"https://api.vaquill.ai/external/openapi.json get /api/v1/us/rulemaking/rins/{rin}","href":"/api-reference/us-rulemaking/everything-we-hold-for-one-rin"},{"title":"Unified Agenda history of one RIN","deprecated":null,"version":null,"openapi":"https://api.vaquill.ai/external/openapi.json get /api/v1/us/rulemaking/rins/{rin}/agenda","href":"/api-reference/us-rulemaking/unified-agenda-history-of-one-rin"},{"title":"List and filter Rules Committee records","deprecated":null,"version":null,"openapi":"https://api.vaquill.ai/external/openapi.json get /api/v1/us/rulemaking/committee-records/list","href":"/api-reference/us-rulemaking/list-and-filter-rules-committee-records"},{"title":"One Rules Committee record with its page text","deprecated":null,"version":null,"openapi":"https://api.vaquill.ai/external/openapi.json get /api/v1/us/rulemaking/committee-records/{record_id}","href":"/api-reference/us-rulemaking/one-rules-committee-record-with-its-page-text"}]}]},{"tab":"India API reference","pages":[{"title":"India API reference","href":"/api-guide/coverage/india"}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/integrations"}]}]},"basePath":"","title":"List a state's session laws - Vaquill AI","buildId":"dpl_BSPUBxEoKhhK7HzXVDPxdPvWx4xc","deploymentId":"dpl_BSPUBxEoKhhK7HzXVDPxdPvWx4xc","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-Do6EtGSl.js","utils-id4tQ6My.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-Byrixac4.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-nakYa3Zl.js","snippetPresets-Bq-pUS7h.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-CujTC_9K.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-FneVUsVu.js","shallow-DY9WpUCz.js","getApiPlaygroundDisplay-Bz8WpPfA.js","CodeSnippet-DgCuJg4G.js","CodeSnippets-Dub9c4T0.js","Page-CePXnjd1.js","getPastedJson-xdI8y2XB.js","icon--yVw5vkr.js","MethodPill-C47t7MdS.js","DuplicateIcon-BzwJ2LeC.js","createIcon-BzggGy84.js","DynamicMarkdown-AlxJK8VR.js","SectionHeading-CMlwFxdK.js","axios-vUo_bRtp.js","Markdown-BNgNrPsi.js","clsx-apD-Q0Oo.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-qmLwQyWY.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Dc4qTkWx.js"]}