{
"laws": [
{
"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,
"coverageStatus": "complete"
},
"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",
"citationAsPrinted": "CHAPTER 1--S.F.No. 1552",
"vetoStatusAsPrinted": "Signed by the governor March 17, 2025, 10:54 a.m.",
"effectiveDates": [],
"otherDates": [
{
"kind": "approved",
"date": "2025-03-17",
"dateAsPrinted": "March 17, 2025, 10:54 a.m."
},
{
"kind": "other",
"date": "2025-03-14",
"dateAsPrinted": "March 14, 2025",
"kindAsPrinted": "Presentment Date"
},
{
"kind": "other",
"date": "2025-03-14",
"dateAsPrinted": "March 14, 2025",
"kindAsPrinted": "Presented to the governor"
}
],
"codeSectionsAffected": [],
"sourceUrl": "https://www.revisor.mn.gov/laws/2025/0/Session+Law/Chapter/1/",
"sources": [
{
"sourceIndex": 0,
"role": "text",
"url": "https://www.revisor.mn.gov/laws/2025/0/Session+Law/Chapter/1/",
"fetchedAt": "2026-09-29T00:41:01+00:00",
"contentType": "text/html; charset=utf-8",
"sha256": "6c83d9c109c1ec61fcd96cea92c8c48414df7ae7dfda7452ebcfbddc181b6b45",
"byteLength": 69907,
"hostClass": "gov"
},
{
"sourceIndex": 1,
"role": "identity",
"url": "https://www.revisor.mn.gov/laws/2025/0/",
"fetchedAt": "2026-09-29T00:41:00+00:00",
"contentType": "text/html; charset=utf-8",
"sha256": "7c7e4d1195d3e82ec1b26a20687f8b4532f4e06bde6297a6c1a7963f92cedcb1",
"byteLength": 89348,
"hostClass": "gov"
}
],
"publisher": {
"legislatureNumber": 94,
"sessionLastYear": 2025,
"publisherIds": [],
"otherCitations": [],
"publisherFields": {
"Chapter": "Chapter 1",
"Bill": "SF1552",
"Presentment Date": "March 14, 2025"
},
"publisherFieldsOmitted": []
},
"provenance": {
"textMethod": "html",
"caveats": [
"session_label '2025 Regular Session' is the title of the session index page; the chapter page also names its own session ('2025 Regular Session') and bill, both checked against the index, since every special session restarts chapter numbering at 1 and session_ordinal 0 is part of identity.",
"Amendatory markup kept as the publisher's literal markers. Raw HTML: 16 'new text begin', 16 'new text end', 12 'deleted text begin', 12 'deleted text end', alongside 16 <ins> and 12 line-through spans that duplicate them typographically (not also written as wdiff). Extracted text: 16 'new text begin', 16 'new text end', 12 'deleted text begin', 12 'deleted text end'. Counts match."
]
},
"input": "SSL_MN_2025R_G_Y2025_C1",
"status": "resolved"
},
{
"sessionLawId": "SSL_LA_2025R_G_C2",
"jurisdiction": "la",
"citation": "ACT No. 2",
"citableAs": "La. Acts 2025, No. 2",
"citationShort": "LA Act 2 (2025)",
"session": {
"code": "2025R",
"label": "2025 Regular Session",
"type": "regular",
"year": 2025
},
"series": "general",
"instrumentType": "act",
"number": "2",
"billNumber": "HOUSE BILL NO. 2",
"title": "To provide with respect to the capital outlay budget and the capital outlay program for state government, state institutions, and other public entities; to provide for the designation of projects and improvements; to provide for the financing thereof making appropriations from certain sources; and to provide for related matters.",
"approvedDate": "2025-06-20",
"approvedDateDerived": false,
"effectiveFirst": "2025-06-20",
"effectiveLast": "2025-06-20",
"enactmentOutcome": "signed",
"isLaw": true,
"textStatus": "withheld",
"withheldReason": "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.",
"charCount": 290570,
"textSha256": "20b4b897e95427a214dc2c41e37ffabb18513751537d3486d7ffbc22ef639af7",
"versionNo": 1,
"amendatoryMarkup": "absent",
"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:01:58.992647+00:00",
"citationAsPrinted": "ACT No. 2",
"vetoStatusAsPrinted": "Signed by the Governor - Act 2",
"pageCount": 162,
"effectiveDates": [
{
"date": "2025-06-20",
"dateAsPrinted": "06/20/25"
}
],
"otherDates": [
{
"kind": "approved",
"date": "2025-06-20",
"dateAsPrinted": "06/20/25"
}
],
"codeSectionsAffected": [],
"sourceUrl": "https://www.legis.la.gov/legis/ViewDocument.aspx?d=1426048",
"sources": [
{
"sourceIndex": 0,
"role": "text",
"url": "https://www.legis.la.gov/legis/ViewDocument.aspx?d=1426048",
"fetchedAt": "2026-09-29T00:37:45+00:00",
"contentType": "application/pdf",
"sha256": "4fb7220c0f502ff45ee57d7febaa1d86a1d3f94ab239f98d060d3a95c6a053ec",
"byteLength": 560862,
"hostClass": "gov"
}
],
"input": "SSL_LA_2025R_G_C2",
"status": "resolved"
}
],
"resolved": [],
"notFound": [
{
"input": "SSL_MN_1801R_G_Y1801_C9999",
"status": "not_found",
"reason": "not_in_registry",
"detail": "Session law not found. No law in the registry carries this id. Take ids from a /us/session-laws/list result, or send the citation in its place.",
"didYouMean": []
}
],
"count": 2,
"deduped": 0,
"creditsConsumed": 4,
"processingTimeMs": 584.9
}
Get many state session laws at once, by id or citation
Read up to 50 STATE session laws in one call: the same record
GET /us/session-laws/{sessionLawId} returns, for each id or citation in ids, in the order
you sent them. Use it when you are enriching a list (a sync job holding ids from
/us/session-laws/list or /us/session-laws/changes, or an agent handed a memo with a dozen
session-law citations) instead of making a round trip per law.
When to use this instead of POST /us/statutes/resolve.resolve identifies a citation: it
costs 2 credits per item and answers with a sessionLaw match block (title, dates, source
link), never the record or its text. This route returns the FULL record of each law, the same as
GET /us/session-laws/{sessionLawId} (2 credits per law served), and optionally the
first page of its text. Use resolve to find the id; use this route to read many laws in one
request instead of one call each, which matters under the default limit of 30 requests per
minute per key (a plan raises it).
Cost: 2 credits per law served, the single-lookup price. Batching buys a round
trip, not a discount. A miss is not charged, and creditsConsumed reports what was actually
billed. A citation in ids also pays the /us/statutes/resolve price (2 credits), as its
own ledger line, exactly as GET /us/session-laws/{sessionLawId} charges a citation: kept
whenever we gave a verdict (a served law, an unresolved or ambiguous citation) and refunded
when the session it points into is only partly collected, or when we failed. An id never pays it.
Every entry gets an answer. A served law is in laws; every other entry is in notFound with
a status (not_found, unparsed, ambiguous, needs_jurisdiction,
session_not_fully_collected, federal, or error), the finer reason the single routeโs 404
carries, the same detail sentence, and the candidates where there are any. Nothing is dropped
silently, so a shorter laws array can always be explained: every distinct entry is in laws,
in notFound, or, when it names a law an earlier entry already produced, in resolved.
Mapping your inputs.laws holds only the laws served, so it cannot be zipped back onto
ids by position. Each law carries the input it answers, and resolved lists every input that
did not match an id exactly as sent (a citation, or an id cleaned of whitespace, quotes or a
trailing period) with the id it resolved to. Duplicates are collapsed first: an entry
identical to an earlier one after trimming is dropped, order is kept, and deduped says how many.
Two DIFFERENT spellings of one law (S.F.No. 1552 and its sessionLawId) serve the law once,
under the first, bill it once, and list both in resolved.
Statuses.resolved: served. not_held: served as a record, because the registry knows the
law and holds no text (textStatus: not_held). not_found: no law carries the id. unparsed: it
reads as a citation no state session law we hold carries. ambiguous: the citation names several
laws, all in didYouMean, none chosen for you (Minnesota 2025 has two Chapter 1s).
needs_jurisdiction: a form several states share, naming none: send jurisdiction or name the
state. session_not_fully_collected: nothing matched in a session we have only partly collected, so
the law may exist; never charged, the resolve price included. federal: federal acts are served
by /us/statutes/section. error: WE failed to look this entry up. It says nothing about the law, is refunded
in full, and is safe to resend.
jurisdiction scopes how every citation in the batch is read, exactly as the same parameter
does on the single route. It is validated before anything is charged: a bad code is a 422.
includeBody adds the FIRST page of each served lawโs text (about 30,000 characters)
as body, at the body price (6 credits) per law whose page is served, charged after the
work because the count is not knowable up front. It multiplies with the batch: 50 laws at
2 + 6 is 400 credits in one call. A law whose text is withheld, not held or
empty returns body: null and is not charged for it. If your balance cannot cover the pages after
the records were served, the records are returned without bodies rather than taking the paid-for
result away. bodyNextCursor continues a longer act on GET /us/session-laws/{sessionLawId}/body.
Limits. At most 50 DISTINCT entries after duplicates collapse (a raw list of up to
200 is accepted so a run of repeats is not refused), each at most 300 characters. An
empty list, an over-long entry, more than 50 distinct entries or a bad jurisdiction is a 422
and nothing is charged. At most 8 lookups run at once inside a call.
GET /us/session-laws/{sessionLawId} is the single read, with the same record and rules.
GET /us/session-laws/list and GET /us/session-laws/changes are where the ids come from.
GET /us/statutes/resolve points a session-law citation here.
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.
Rate limits. Calls count against your keyโs per-minute budget like every Data API route; a
429 carries Retry-After.
POST
/
api
/
v1
/
us
/
session-laws
/
batch
Get many state session laws at once, by id or citation
{
"laws": [
{
"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,
"coverageStatus": "complete"
},
"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",
"citationAsPrinted": "CHAPTER 1--S.F.No. 1552",
"vetoStatusAsPrinted": "Signed by the governor March 17, 2025, 10:54 a.m.",
"effectiveDates": [],
"otherDates": [
{
"kind": "approved",
"date": "2025-03-17",
"dateAsPrinted": "March 17, 2025, 10:54 a.m."
},
{
"kind": "other",
"date": "2025-03-14",
"dateAsPrinted": "March 14, 2025",
"kindAsPrinted": "Presentment Date"
},
{
"kind": "other",
"date": "2025-03-14",
"dateAsPrinted": "March 14, 2025",
"kindAsPrinted": "Presented to the governor"
}
],
"codeSectionsAffected": [],
"sourceUrl": "https://www.revisor.mn.gov/laws/2025/0/Session+Law/Chapter/1/",
"sources": [
{
"sourceIndex": 0,
"role": "text",
"url": "https://www.revisor.mn.gov/laws/2025/0/Session+Law/Chapter/1/",
"fetchedAt": "2026-09-29T00:41:01+00:00",
"contentType": "text/html; charset=utf-8",
"sha256": "6c83d9c109c1ec61fcd96cea92c8c48414df7ae7dfda7452ebcfbddc181b6b45",
"byteLength": 69907,
"hostClass": "gov"
},
{
"sourceIndex": 1,
"role": "identity",
"url": "https://www.revisor.mn.gov/laws/2025/0/",
"fetchedAt": "2026-09-29T00:41:00+00:00",
"contentType": "text/html; charset=utf-8",
"sha256": "7c7e4d1195d3e82ec1b26a20687f8b4532f4e06bde6297a6c1a7963f92cedcb1",
"byteLength": 89348,
"hostClass": "gov"
}
],
"publisher": {
"legislatureNumber": 94,
"sessionLastYear": 2025,
"publisherIds": [],
"otherCitations": [],
"publisherFields": {
"Chapter": "Chapter 1",
"Bill": "SF1552",
"Presentment Date": "March 14, 2025"
},
"publisherFieldsOmitted": []
},
"provenance": {
"textMethod": "html",
"caveats": [
"session_label '2025 Regular Session' is the title of the session index page; the chapter page also names its own session ('2025 Regular Session') and bill, both checked against the index, since every special session restarts chapter numbering at 1 and session_ordinal 0 is part of identity.",
"Amendatory markup kept as the publisher's literal markers. Raw HTML: 16 'new text begin', 16 'new text end', 12 'deleted text begin', 12 'deleted text end', alongside 16 <ins> and 12 line-through spans that duplicate them typographically (not also written as wdiff). Extracted text: 16 'new text begin', 16 'new text end', 12 'deleted text begin', 12 'deleted text end'. Counts match."
]
},
"input": "SSL_MN_2025R_G_Y2025_C1",
"status": "resolved"
},
{
"sessionLawId": "SSL_LA_2025R_G_C2",
"jurisdiction": "la",
"citation": "ACT No. 2",
"citableAs": "La. Acts 2025, No. 2",
"citationShort": "LA Act 2 (2025)",
"session": {
"code": "2025R",
"label": "2025 Regular Session",
"type": "regular",
"year": 2025
},
"series": "general",
"instrumentType": "act",
"number": "2",
"billNumber": "HOUSE BILL NO. 2",
"title": "To provide with respect to the capital outlay budget and the capital outlay program for state government, state institutions, and other public entities; to provide for the designation of projects and improvements; to provide for the financing thereof making appropriations from certain sources; and to provide for related matters.",
"approvedDate": "2025-06-20",
"approvedDateDerived": false,
"effectiveFirst": "2025-06-20",
"effectiveLast": "2025-06-20",
"enactmentOutcome": "signed",
"isLaw": true,
"textStatus": "withheld",
"withheldReason": "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.",
"charCount": 290570,
"textSha256": "20b4b897e95427a214dc2c41e37ffabb18513751537d3486d7ffbc22ef639af7",
"versionNo": 1,
"amendatoryMarkup": "absent",
"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:01:58.992647+00:00",
"citationAsPrinted": "ACT No. 2",
"vetoStatusAsPrinted": "Signed by the Governor - Act 2",
"pageCount": 162,
"effectiveDates": [
{
"date": "2025-06-20",
"dateAsPrinted": "06/20/25"
}
],
"otherDates": [
{
"kind": "approved",
"date": "2025-06-20",
"dateAsPrinted": "06/20/25"
}
],
"codeSectionsAffected": [],
"sourceUrl": "https://www.legis.la.gov/legis/ViewDocument.aspx?d=1426048",
"sources": [
{
"sourceIndex": 0,
"role": "text",
"url": "https://www.legis.la.gov/legis/ViewDocument.aspx?d=1426048",
"fetchedAt": "2026-09-29T00:37:45+00:00",
"contentType": "application/pdf",
"sha256": "4fb7220c0f502ff45ee57d7febaa1d86a1d3f94ab239f98d060d3a95c6a053ec",
"byteLength": 560862,
"hostClass": "gov"
}
],
"input": "SSL_LA_2025R_G_C2",
"status": "resolved"
}
],
"resolved": [],
"notFound": [
{
"input": "SSL_MN_1801R_G_Y1801_C9999",
"status": "not_found",
"reason": "not_in_registry",
"detail": "Session law not found. No law in the registry carries this id. Take ids from a /us/session-laws/list result, or send the citation in its place.",
"didYouMean": []
}
],
"count": 2,
"deduped": 0,
"creditsConsumed": 4,
"processingTimeMs": 584.9
}
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.
State session law ids, or citations, to read: up to 50 DISTINCT entries per call. Each entry is read exactly as the {sessionLawId} path of GET /us/session-laws/{sessionLawId} reads one: an id as sent, an id carrying copy damage, or a citation (Minn. Laws 2025, ch. 1, P.A. 104-0001, S.F.No. 1552). Entries are trimmed, and blank ones are dropped. Duplicates collapse FIRST (the first spelling wins, order is kept) and the cap applies to what is left, so a list quoting one law sixty times is one entry; deduped says how many were collapsed. 200 is the ceiling on the raw list. An entry is at most 300 characters. Federal ids (SAL_...) and endpoint names are misses, never charged. A CITATION also pays the resolve price (2 credits) whether it resolves or not, because the lookup is the verdict: an unresolved, ambiguous or state-less citation keeps it. It is refunded only when the session is partly collected or we failed. An id never pays it.
Optional two-letter state code that scopes how a CITATION in ids is read, for the whole batch: it supplies the state a citation does not name (Laws 2025, ch. 1 with mn is Minnesota's) and vetoes a state the citation does name or whose form belongs to another. Ignored for an id. The 50 states, dc and pr, case-insensitive; federal or an unknown code is a 422 and nothing is charged. Omit it for a batch whose citations each name their own state.
Return the FIRST page of each served law's text inline, on body, beside the record. A page is about 30,000 characters and costs the ordinary body price (6 credits) per law whose page is served; a law whose text is withheld, not held or empty comes back with body: null and is not charged for it. Read creditsConsumed rather than computing the total: the worst case is 50 laws at 2 + 6 credits each. bodyNextCursor continues a longer act on GET /us/session-laws/{sessionLawId}/body.
Example:
true
Response
One entry per distinct id or citation: the served laws in laws, every other entry in notFound with its status and reason. Not every entry is a law: read notFound, and creditsConsumed for what was billed.
The served laws, one per distinct law, in the order the entries of ids first reached them. Entries that missed are NOT here, so a client mapping by position must use input on each law (or notFound), never the index.
One entry per input that did NOT match an id exactly as sent: a citation resolved to its law, or an id cleaned of whitespace, quotes or a trailing period. Includes an input whose law an earlier entry already produced, so every input is mappable onto laws. Empty when every entry was an exact id.
Every entry that did not yield a law, in the order sent, each with its status and reason. A miss is not charged for the route's own price. An entry read as a CITATION also paid the resolve price, kept whenever we gave a verdict on it (unparsed, ambiguous, needs_jurisdiction, federal) and refunded on session_not_fully_collected and error. An id pays no resolve price.
How many entries of ids were collapsed because an earlier entry was identical after trimming. Zero when none were. Two DIFFERENT spellings of one law are not counted here: the law appears once in laws and both spellings are in resolved.
Set only when includeBody was sent and the bodies were withheld for the whole call: either your balance could not cover them, or the charge for them could not be completed on our side. Either way no body was returned and none was charged, and the laws are intact. Absent otherwise.
Credits actually charged for this call, never the list price: 2 per law served, plus the 2-credit resolve price for each citation whose resolution is kept, plus the body price per body served. Misses and failures bill nothing for the route.
Server-side time for this request in milliseconds, excluding network transit. Not billed on.
Example:
512.3
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/get-many-state-session-laws-at-once-by-id-or-citation","slug":"/api-reference/us-session-laws/get-many-state-session-laws-at-once-by-id-or-citation","pageMetadata":{"title":"Get many state session laws at once, by id or citation","description":"Read up to 50 STATE session laws in one call: the same record\n`GET /us/session-laws/{sessionLawId}` returns, for each id or citation in `ids`, in the order\nyou sent them. Use it when you are enriching a list (a sync job holding ids from\n`/us/session-laws/list` or `/us/session-laws/changes`, or an agent handed a memo with a dozen\nsession-law citations) instead of making a round trip per law.\n\n**When to use this instead of `POST /us/statutes/resolve`.** `resolve` identifies a citation: it\ncosts 2 credits per item and answers with a `sessionLaw` match block (title, dates, source\nlink), never the record or its text. This route returns the FULL record of each law, the same as\n`GET /us/session-laws/{sessionLawId}` (2 credits per law served), and optionally the\nfirst page of its text. Use `resolve` to find the id; use this route to read many laws in one\nrequest instead of one call each, which matters under the default limit of 30 requests per\nminute per key (a plan raises it).\n\n**Cost**: 2 credits per law served, the single-lookup price. Batching buys a round\ntrip, not a discount. A miss is not charged, and `creditsConsumed` reports what was actually\nbilled. A citation in `ids` also pays the `/us/statutes/resolve` price (2 credits), as its\nown ledger line, exactly as `GET /us/session-laws/{sessionLawId}` charges a citation: kept\nwhenever we gave a verdict (a served law, an unresolved or ambiguous citation) and refunded\nwhen the session it points into is only partly collected, or when we failed. An id never pays it.\n\n**Every entry gets an answer.** A served law is in `laws`; every other entry is in `notFound` with\na `status` (`not_found`, `unparsed`, `ambiguous`, `needs_jurisdiction`,\n`session_not_fully_collected`, `federal`, or `error`), the finer `reason` the single route's 404\ncarries, the same `detail` sentence, and the candidates where there are any. Nothing is dropped\nsilently, so a shorter `laws` array can always be explained: every distinct entry is in `laws`,\nin `notFound`, or, when it names a law an earlier entry already produced, in `resolved`.\n\n**Mapping your inputs.** `laws` holds only the laws served, so it cannot be zipped back onto\n`ids` by position. Each law carries the `input` it answers, and `resolved` lists every input that\ndid not match an id exactly as sent (a citation, or an id cleaned of whitespace, quotes or a\ntrailing period) with the id it resolved to. **Duplicates are collapsed first**: an entry\nidentical to an earlier one after trimming is dropped, order is kept, and `deduped` says how many.\nTwo DIFFERENT spellings of one law (`S.F.No. 1552` and its `sessionLawId`) serve the law once,\nunder the first, bill it once, and list both in `resolved`.\n\n**Statuses.** `resolved`: served. `not_held`: served as a record, because the registry knows the\nlaw and holds no text (`textStatus: not_held`). `not_found`: no law carries the id. `unparsed`: it\nreads as a citation no state session law we hold carries. `ambiguous`: the citation names several\nlaws, all in `didYouMean`, none chosen for you (Minnesota 2025 has two Chapter 1s).\n`needs_jurisdiction`: a form several states share, naming none: send `jurisdiction` or name the\nstate. `session_not_fully_collected`: nothing matched in a session we have only partly collected, so\nthe law may exist; never charged, the resolve price included. `federal`: federal acts are served\nby `/us/statutes/section`. `error`: WE failed to look this entry up. It says nothing about the law, is refunded\nin full, and is safe to resend.\n\n**`jurisdiction`** scopes how every citation in the batch is read, exactly as the same parameter\ndoes on the single route. It is validated before anything is charged: a bad code is a 422.\n\n**`includeBody`** adds the FIRST page of each served law's text (about 30,000 characters)\nas `body`, at the body price (6 credits) per law whose page is served, charged after the\nwork because the count is not knowable up front. It multiplies with the batch: 50 laws at\n2 + 6 is 400 credits in one call. A law whose text is withheld, not held or\nempty returns `body: null` and is not charged for it. If your balance cannot cover the pages after\nthe records were served, the records are returned without bodies rather than taking the paid-for\nresult away. `bodyNextCursor` continues a longer act on `GET /us/session-laws/{sessionLawId}/body`.\n\n**Limits.** At most 50 DISTINCT entries after duplicates collapse (a raw list of up to\n200 is accepted so a run of repeats is not refused), each at most 300 characters. An\nempty list, an over-long entry, more than 50 distinct entries or a bad `jurisdiction` is a 422\nand nothing is charged. At most 8 lookups run at once inside a call.\n\n**Example**\n\n```bash\ncurl -X POST \"https://api.vaquill.ai/api/v1/us/session-laws/batch\" \\\n -H \"Authorization: Bearer $VAQUILL_API_KEY\" -H \"Content-Type: application/json\" \\\n -d '{\"ids\": [\"SSL_MN_2025R_G_Y2025_C1\", \"S.F.No. 1552\"], \"jurisdiction\": \"mn\"}'\n```\n\n```javascript\nconst res = await fetch(\"https://api.vaquill.ai/api/v1/us/session-laws/batch\", {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${process.env.VAQUILL_API_KEY}`,\n \"Content-Type\": \"application/json\",\n },\n body: JSON.stringify({ ids: [\"SSL_MN_2025R_G_Y2025_C1\", \"S.F.No. 1552\"], jurisdiction: \"mn\" }),\n});\nconst { laws, notFound, resolved } = await res.json();\nconst byInput = new Map(laws.map((law) => [law.input, law]));\n```\n\n**Related endpoints**\n\n- `GET /us/session-laws/{sessionLawId}` is the single read, with the same record and rules.\n- `GET /us/session-laws/list` and `GET /us/session-laws/changes` are where the ids come from.\n- `GET /us/statutes/resolve` points a session-law citation here.\n\n**Nulls.** Every field of a response is always present: one with no value is `null` (or `[]`\nfor a list). The examples 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\n429 carries `Retry-After`.","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","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: [\"Read up to 50 STATE session laws in one call: the same record\\n\", _jsx(_components.code, {\n children: \"GET /us/session-laws/{sessionLawId}\"\n }), \" returns, for each id or citation in \", _jsx(_components.code, {\n children: \"ids\"\n }), \", in the order\\nyou sent them. Use it when you are enriching a list (a sync job holding ids from\\n\", _jsx(_components.code, {\n children: \"/us/session-laws/list\"\n }), \" or \", _jsx(_components.code, {\n children: \"/us/session-laws/changes\"\n }), \", or an agent handed a memo with a dozen\\nsession-law citations) instead of making a round trip per law.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsxs(_components.strong, {\n children: [\"When to use this instead of \", _jsx(_components.code, {\n children: \"POST /us/statutes/resolve\"\n }), \".\"]\n }), \" \", _jsx(_components.code, {\n children: \"resolve\"\n }), \" identifies a citation: it\\ncosts 2 credits per item and answers with a \", _jsx(_components.code, {\n children: \"sessionLaw\"\n }), \" match block (title, dates, source\\nlink), never the record or its text. This route returns the FULL record of each law, the same as\\n\", _jsx(_components.code, {\n children: \"GET /us/session-laws/{sessionLawId}\"\n }), \" (2 credits per law served), and optionally the\\nfirst page of its text. Use \", _jsx(_components.code, {\n children: \"resolve\"\n }), \" to find the id; use this route to read many laws in one\\nrequest instead of one call each, which matters under the default limit of 30 requests per\\nminute per key (a plan raises it).\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Cost\"\n }), \": 2 credits per law served, the single-lookup price. Batching buys a round\\ntrip, not a discount. A miss is not charged, and \", _jsx(_components.code, {\n children: \"creditsConsumed\"\n }), \" reports what was actually\\nbilled. A citation in \", _jsx(_components.code, {\n children: \"ids\"\n }), \" also pays the \", _jsx(_components.code, {\n children: \"/us/statutes/resolve\"\n }), \" price (2 credits), as its\\nown ledger line, exactly as \", _jsx(_components.code, {\n children: \"GET /us/session-laws/{sessionLawId}\"\n }), \" charges a citation: kept\\nwhenever we gave a verdict (a served law, an unresolved or ambiguous citation) and refunded\\nwhen the session it points into is only partly collected, or when we failed. An id never pays it.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Every entry gets an answer.\"\n }), \" A served law is in \", _jsx(_components.code, {\n children: \"laws\"\n }), \"; every other entry is in \", _jsx(_components.code, {\n children: \"notFound\"\n }), \" with\\na \", _jsx(_components.code, {\n children: \"status\"\n }), \" (\", _jsx(_components.code, {\n children: \"not_found\"\n }), \", \", _jsx(_components.code, {\n children: \"unparsed\"\n }), \", \", _jsx(_components.code, {\n children: \"ambiguous\"\n }), \", \", _jsx(_components.code, {\n children: \"needs_jurisdiction\"\n }), \",\\n\", _jsx(_components.code, {\n children: \"session_not_fully_collected\"\n }), \", \", _jsx(_components.code, {\n children: \"federal\"\n }), \", or \", _jsx(_components.code, {\n children: \"error\"\n }), \"), the finer \", _jsx(_components.code, {\n children: \"reason\"\n }), \" the single routeโs 404\\ncarries, the same \", _jsx(_components.code, {\n children: \"detail\"\n }), \" sentence, and the candidates where there are any. Nothing is dropped\\nsilently, so a shorter \", _jsx(_components.code, {\n children: \"laws\"\n }), \" array can always be explained: every distinct entry is in \", _jsx(_components.code, {\n children: \"laws\"\n }), \",\\nin \", _jsx(_components.code, {\n children: \"notFound\"\n }), \", or, when it names a law an earlier entry already produced, in \", _jsx(_components.code, {\n children: \"resolved\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Mapping your inputs.\"\n }), \" \", _jsx(_components.code, {\n children: \"laws\"\n }), \" holds only the laws served, so it cannot be zipped back onto\\n\", _jsx(_components.code, {\n children: \"ids\"\n }), \" by position. Each law carries the \", _jsx(_components.code, {\n children: \"input\"\n }), \" it answers, and \", _jsx(_components.code, {\n children: \"resolved\"\n }), \" lists every input that\\ndid not match an id exactly as sent (a citation, or an id cleaned of whitespace, quotes or a\\ntrailing period) with the id it resolved to. \", _jsx(_components.strong, {\n children: \"Duplicates are collapsed first\"\n }), \": an entry\\nidentical to an earlier one after trimming is dropped, order is kept, and \", _jsx(_components.code, {\n children: \"deduped\"\n }), \" says how many.\\nTwo DIFFERENT spellings of one law (\", _jsx(_components.code, {\n children: \"S.F.No. 1552\"\n }), \" and its \", _jsx(_components.code, {\n children: \"sessionLawId\"\n }), \") serve the law once,\\nunder the first, bill it once, and list both in \", _jsx(_components.code, {\n children: \"resolved\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Statuses.\"\n }), \" \", _jsx(_components.code, {\n children: \"resolved\"\n }), \": served. \", _jsx(_components.code, {\n children: \"not_held\"\n }), \": served as a record, because the registry knows the\\nlaw and holds no text (\", _jsx(_components.code, {\n children: \"textStatus: not_held\"\n }), \"). \", _jsx(_components.code, {\n children: \"not_found\"\n }), \": no law carries the id. \", _jsx(_components.code, {\n children: \"unparsed\"\n }), \": it\\nreads as a citation no state session law we hold carries. \", _jsx(_components.code, {\n children: \"ambiguous\"\n }), \": the citation names several\\nlaws, all in \", _jsx(_components.code, {\n children: \"didYouMean\"\n }), \", none chosen for you (Minnesota 2025 has two Chapter 1s).\\n\", _jsx(_components.code, {\n children: \"needs_jurisdiction\"\n }), \": a form several states share, naming none: send \", _jsx(_components.code, {\n children: \"jurisdiction\"\n }), \" or name the\\nstate. \", _jsx(_components.code, {\n children: \"session_not_fully_collected\"\n }), \": nothing matched in a session we have only partly collected, so\\nthe law may exist; never charged, the resolve price included. \", _jsx(_components.code, {\n children: \"federal\"\n }), \": federal acts are served\\nby \", _jsx(_components.code, {\n children: \"/us/statutes/section\"\n }), \". \", _jsx(_components.code, {\n children: \"error\"\n }), \": WE failed to look this entry up. It says nothing about the law, is refunded\\nin full, and is safe to resend.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: _jsx(_components.code, {\n children: \"jurisdiction\"\n })\n }), \" scopes how every citation in the batch is read, exactly as the same parameter\\ndoes on the single route. It is validated before anything is charged: a bad code is a 422.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: _jsx(_components.code, {\n children: \"includeBody\"\n })\n }), \" adds the FIRST page of each served lawโs text (about 30,000 characters)\\nas \", _jsx(_components.code, {\n children: \"body\"\n }), \", at the body price (6 credits) per law whose page is served, charged after the\\nwork because the count is not knowable up front. It multiplies with the batch: 50 laws at\\n2 + 6 is 400 credits in one call. A law whose text is withheld, not held or\\nempty returns \", _jsx(_components.code, {\n children: \"body: null\"\n }), \" and is not charged for it. If your balance cannot cover the pages after\\nthe records were served, the records are returned without bodies rather than taking the paid-for\\nresult away. \", _jsx(_components.code, {\n children: \"bodyNextCursor\"\n }), \" continues a longer act on \", _jsx(_components.code, {\n children: \"GET /us/session-laws/{sessionLawId}/body\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Limits.\"\n }), \" At most 50 DISTINCT entries after duplicates collapse (a raw list of up to\\n200 is accepted so a run of repeats is not refused), each at most 300 characters. An\\nempty list, an over-long entry, more than 50 distinct entries or a bad \", _jsx(_components.code, {\n children: \"jurisdiction\"\n }), \" is a 422\\nand nothing is charged. At most 8 lookups run at once inside a call.\"]\n }), \"\\n\", _jsx(_components.p, {\n children: _jsx(_components.strong, {\n children: \"Example\"\n })\n }), \"\\n\", _jsx(CodeBlock, {\n numberOfLines: \"3\",\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: \"3\",\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: \"#0550AE\",\n \"--shiki-dark\": \"#569CD6\"\n },\n children: \" -X\"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \" POST\"\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/batch\\\"\"\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 }), _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: \" \\\"Content-Type: application/json\\\"\"\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: \" -d\"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \" '{\\\"ids\\\": [\\\"SSL_MN_2025R_G_Y2025_C1\\\", \\\"S.F.No. 1552\\\"], \\\"jurisdiction\\\": \\\"mn\\\"}'\"\n })]\n }), \"\\n\"]\n })\n })\n }), \"\\n\", _jsx(CodeBlock, {\n numberOfLines: \"10\",\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: \"10\",\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: \" 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: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \"\\\"https://api.vaquill.ai/api/v1/us/session-laws/batch\\\"\"\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: \" method:\"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \" \\\"POST\\\"\"\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 })]\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: \" 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\", _jsxs(_components.span, {\n className: \"line\",\n children: [_jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \" \\\"Content-Type\\\"\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#9CDCFE\"\n },\n children: \":\"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \" \\\"application/json\\\"\"\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: \"#1F2328\",\n \"--shiki-dark\": \"#9CDCFE\"\n },\n children: \" body:\"\n }), _jsx(_components.span, {\n style: {\n color: \"#0550AE\",\n \"--shiki-dark\": \"#4FC1FF\"\n },\n children: \" JSON\"\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: \"stringify\"\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: \"ids:\"\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: \"\\\"SSL_MN_2025R_G_Y2025_C1\\\"\"\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: \"\\\"S.F.No. 1552\\\"\"\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 })]\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: \"laws\"\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: \"notFound\"\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: \"resolved\"\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\", _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: \" byInput\"\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: \" Map\"\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: \"laws\"\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: \"map\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \"((\"\n }), _jsx(_components.span, {\n style: {\n color: \"#953800\",\n \"--shiki-dark\": \"#9CDCFE\"\n },\n children: \"law\"\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\": \"#569CD6\"\n },\n children: \"=>\"\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: \"law\"\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: \"input\"\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: \"law\"\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/session-laws/{sessionLawId}\"\n }), \" is the single read, with the same record and rules.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"GET /us/session-laws/list\"\n }), \" and \", _jsx(_components.code, {\n children: \"GET /us/session-laws/changes\"\n }), \" are where the ids come from.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"GET /us/statutes/resolve\"\n }), \" points a session-law citation here.\"]\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 }), \" (or \", _jsx(_components.code, {\n children: \"[]\"\n }), \"\\nfor a list). The examples on this page leave the nulls out for brevity.\"]\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 API route; a\\n429 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":"Get many state session laws at once, by id or citation","description":"Read up to 50 STATE session laws in one call: the same record\n`GET /us/session-laws/{sessionLawId}` returns, for each id or citation in `ids`, in the order\nyou sent them. Use it when you are enriching a list (a sync job holding ids from\n`/us/session-laws/list` or `/us/session-laws/changes`, or an agent handed a memo with a dozen\nsession-law citations) instead of making a round trip per law.\n\n**When to use this instead of `POST /us/statutes/resolve`.** `resolve` identifies a citation: it\ncosts 2 credits per item and answers with a `sessionLaw` match block (title, dates, source\nlink), never the record or its text. This route returns the FULL record of each law, the same as\n`GET /us/session-laws/{sessionLawId}` (2 credits per law served), and optionally the\nfirst page of its text. Use `resolve` to find the id; use this route to read many laws in one\nrequest instead of one call each, which matters under the default limit of 30 requests per\nminute per key (a plan raises it).\n\n**Cost**: 2 credits per law served, the single-lookup price. Batching buys a round\ntrip, not a discount. A miss is not charged, and `creditsConsumed` reports what was actually\nbilled. A citation in `ids` also pays the `/us/statutes/resolve` price (2 credits), as its\nown ledger line, exactly as `GET /us/session-laws/{sessionLawId}` charges a citation: kept\nwhenever we gave a verdict (a served law, an unresolved or ambiguous citation) and refunded\nwhen the session it points into is only partly collected, or when we failed. An id never pays it.\n\n**Every entry gets an answer.** A served law is in `laws`; every other entry is in `notFound` with\na `status` (`not_found`, `unparsed`, `ambiguous`, `needs_jurisdiction`,\n`session_not_fully_collected`, `federal`, or `error`), the finer `reason` the single route's 404\ncarries, the same `detail` sentence, and the candidates where there are any. Nothing is dropped\nsilently, so a shorter `laws` array can always be explained: every distinct entry is in `laws`,\nin `notFound`, or, when it names a law an earlier entry already produced, in `resolved`.\n\n**Mapping your inputs.** `laws` holds only the laws served, so it cannot be zipped back onto\n`ids` by position. Each law carries the `input` it answers, and `resolved` lists every input that\ndid not match an id exactly as sent (a citation, or an id cleaned of whitespace, quotes or a\ntrailing period) with the id it resolved to. **Duplicates are collapsed first**: an entry\nidentical to an earlier one after trimming is dropped, order is kept, and `deduped` says how many.\nTwo DIFFERENT spellings of one law (`S.F.No. 1552` and its `sessionLawId`) serve the law once,\nunder the first, bill it once, and list both in `resolved`.\n\n**Statuses.** `resolved`: served. `not_held`: served as a record, because the registry knows the\nlaw and holds no text (`textStatus: not_held`). `not_found`: no law carries the id. `unparsed`: it\nreads as a citation no state session law we hold carries. `ambiguous`: the citation names several\nlaws, all in `didYouMean`, none chosen for you (Minnesota 2025 has two Chapter 1s).\n`needs_jurisdiction`: a form several states share, naming none: send `jurisdiction` or name the\nstate. `session_not_fully_collected`: nothing matched in a session we have only partly collected, so\nthe law may exist; never charged, the resolve price included. `federal`: federal acts are served\nby `/us/statutes/section`. `error`: WE failed to look this entry up. It says nothing about the law, is refunded\nin full, and is safe to resend.\n\n**`jurisdiction`** scopes how every citation in the batch is read, exactly as the same parameter\ndoes on the single route. It is validated before anything is charged: a bad code is a 422.\n\n**`includeBody`** adds the FIRST page of each served law's text (about 30,000 characters)\nas `body`, at the body price (6 credits) per law whose page is served, charged after the\nwork because the count is not knowable up front. It multiplies with the batch: 50 laws at\n2 + 6 is 400 credits in one call. A law whose text is withheld, not held or\nempty returns `body: null` and is not charged for it. If your balance cannot cover the pages after\nthe records were served, the records are returned without bodies rather than taking the paid-for\nresult away. `bodyNextCursor` continues a longer act on `GET /us/session-laws/{sessionLawId}/body`.\n\n**Limits.** At most 50 DISTINCT entries after duplicates collapse (a raw list of up to\n200 is accepted so a run of repeats is not refused), each at most 300 characters. An\nempty list, an over-long entry, more than 50 distinct entries or a bad `jurisdiction` is a 422\nand nothing is charged. At most 8 lookups run at once inside a call.\n\n**Example**\n\n```bash\ncurl -X POST \"https://api.vaquill.ai/api/v1/us/session-laws/batch\" \\\n -H \"Authorization: Bearer $VAQUILL_API_KEY\" -H \"Content-Type: application/json\" \\\n -d '{\"ids\": [\"SSL_MN_2025R_G_Y2025_C1\", \"S.F.No. 1552\"], \"jurisdiction\": \"mn\"}'\n```\n\n```javascript\nconst res = await fetch(\"https://api.vaquill.ai/api/v1/us/session-laws/batch\", {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${process.env.VAQUILL_API_KEY}`,\n \"Content-Type\": \"application/json\",\n },\n body: JSON.stringify({ ids: [\"SSL_MN_2025R_G_Y2025_C1\", \"S.F.No. 1552\"], jurisdiction: \"mn\" }),\n});\nconst { laws, notFound, resolved } = await res.json();\nconst byInput = new Map(laws.map((law) => [law.input, law]));\n```\n\n**Related endpoints**\n\n- `GET /us/session-laws/{sessionLawId}` is the single read, with the same record and rules.\n- `GET /us/session-laws/list` and `GET /us/session-laws/changes` are where the ids come from.\n- `GET /us/statutes/resolve` points a session-law citation here.\n\n**Nulls.** Every field of a response is always present: one with no value is `null` (or `[]`\nfor a list). The examples 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\n429 carries `Retry-After`.","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","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["US Session Laws"],"summary":"Get many state session laws at once, by id or citation","description":"Read up to 50 STATE session laws in one call: the same record\n`GET /us/session-laws/{sessionLawId}` returns, for each id or citation in `ids`, in the order\nyou sent them. Use it when you are enriching a list (a sync job holding ids from\n`/us/session-laws/list` or `/us/session-laws/changes`, or an agent handed a memo with a dozen\nsession-law citations) instead of making a round trip per law.\n\n**When to use this instead of `POST /us/statutes/resolve`.** `resolve` identifies a citation: it\ncosts 2 credits per item and answers with a `sessionLaw` match block (title, dates, source\nlink), never the record or its text. This route returns the FULL record of each law, the same as\n`GET /us/session-laws/{sessionLawId}` (2 credits per law served), and optionally the\nfirst page of its text. Use `resolve` to find the id; use this route to read many laws in one\nrequest instead of one call each, which matters under the default limit of 30 requests per\nminute per key (a plan raises it).\n\n**Cost**: 2 credits per law served, the single-lookup price. Batching buys a round\ntrip, not a discount. A miss is not charged, and `creditsConsumed` reports what was actually\nbilled. A citation in `ids` also pays the `/us/statutes/resolve` price (2 credits), as its\nown ledger line, exactly as `GET /us/session-laws/{sessionLawId}` charges a citation: kept\nwhenever we gave a verdict (a served law, an unresolved or ambiguous citation) and refunded\nwhen the session it points into is only partly collected, or when we failed. An id never pays it.\n\n**Every entry gets an answer.** A served law is in `laws`; every other entry is in `notFound` with\na `status` (`not_found`, `unparsed`, `ambiguous`, `needs_jurisdiction`,\n`session_not_fully_collected`, `federal`, or `error`), the finer `reason` the single route's 404\ncarries, the same `detail` sentence, and the candidates where there are any. Nothing is dropped\nsilently, so a shorter `laws` array can always be explained: every distinct entry is in `laws`,\nin `notFound`, or, when it names a law an earlier entry already produced, in `resolved`.\n\n**Mapping your inputs.** `laws` holds only the laws served, so it cannot be zipped back onto\n`ids` by position. Each law carries the `input` it answers, and `resolved` lists every input that\ndid not match an id exactly as sent (a citation, or an id cleaned of whitespace, quotes or a\ntrailing period) with the id it resolved to. **Duplicates are collapsed first**: an entry\nidentical to an earlier one after trimming is dropped, order is kept, and `deduped` says how many.\nTwo DIFFERENT spellings of one law (`S.F.No. 1552` and its `sessionLawId`) serve the law once,\nunder the first, bill it once, and list both in `resolved`.\n\n**Statuses.** `resolved`: served. `not_held`: served as a record, because the registry knows the\nlaw and holds no text (`textStatus: not_held`). `not_found`: no law carries the id. `unparsed`: it\nreads as a citation no state session law we hold carries. `ambiguous`: the citation names several\nlaws, all in `didYouMean`, none chosen for you (Minnesota 2025 has two Chapter 1s).\n`needs_jurisdiction`: a form several states share, naming none: send `jurisdiction` or name the\nstate. `session_not_fully_collected`: nothing matched in a session we have only partly collected, so\nthe law may exist; never charged, the resolve price included. `federal`: federal acts are served\nby `/us/statutes/section`. `error`: WE failed to look this entry up. It says nothing about the law, is refunded\nin full, and is safe to resend.\n\n**`jurisdiction`** scopes how every citation in the batch is read, exactly as the same parameter\ndoes on the single route. It is validated before anything is charged: a bad code is a 422.\n\n**`includeBody`** adds the FIRST page of each served law's text (about 30,000 characters)\nas `body`, at the body price (6 credits) per law whose page is served, charged after the\nwork because the count is not knowable up front. It multiplies with the batch: 50 laws at\n2 + 6 is 400 credits in one call. A law whose text is withheld, not held or\nempty returns `body: null` and is not charged for it. If your balance cannot cover the pages after\nthe records were served, the records are returned without bodies rather than taking the paid-for\nresult away. `bodyNextCursor` continues a longer act on `GET /us/session-laws/{sessionLawId}/body`.\n\n**Limits.** At most 50 DISTINCT entries after duplicates collapse (a raw list of up to\n200 is accepted so a run of repeats is not refused), each at most 300 characters. An\nempty list, an over-long entry, more than 50 distinct entries or a bad `jurisdiction` is a 422\nand nothing is charged. At most 8 lookups run at once inside a call.\n\n**Example**\n\n```bash\ncurl -X POST \"https://api.vaquill.ai/api/v1/us/session-laws/batch\" \\\n -H \"Authorization: Bearer $VAQUILL_API_KEY\" -H \"Content-Type: application/json\" \\\n -d '{\"ids\": [\"SSL_MN_2025R_G_Y2025_C1\", \"S.F.No. 1552\"], \"jurisdiction\": \"mn\"}'\n```\n\n```javascript\nconst res = await fetch(\"https://api.vaquill.ai/api/v1/us/session-laws/batch\", {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${process.env.VAQUILL_API_KEY}`,\n \"Content-Type\": \"application/json\",\n },\n body: JSON.stringify({ ids: [\"SSL_MN_2025R_G_Y2025_C1\", \"S.F.No. 1552\"], jurisdiction: \"mn\" }),\n});\nconst { laws, notFound, resolved } = await res.json();\nconst byInput = new Map(laws.map((law) => [law.input, law]));\n```\n\n**Related endpoints**\n\n- `GET /us/session-laws/{sessionLawId}` is the single read, with the same record and rules.\n- `GET /us/session-laws/list` and `GET /us/session-laws/changes` are where the ids come from.\n- `GET /us/statutes/resolve` points a session-law citation here.\n\n**Nulls.** Every field of a response is always present: one with no value is `null` (or `[]`\nfor a list). The examples 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\n429 carries `Retry-After`.","operationId":"get_session_laws_batch","parameters":["e9c4fb5d-e130-49ca-b161-4cf964fb8e10"],"requestBody":"9c806ca1-b4ff-413b-bff8-426401bd1952","responses":{"200":"fd4496f2-a471-4791-90b3-d24804bc0d45","401":"d99e99cf-3d79-49b3-9ac1-5f61acfdbf91","402":"d97430e5-317a-4c78-a219-b94236738417","403":"615f45c5-4ed3-4366-b71c-a4e298b07633","409":"542377e5-eedf-4d2b-adf7-4341abef5db5","422":"20febb2e-bc05-44a4-9ce3-4d8f4c72e5b2","429":"d58ffde3-43f5-4ee8-a107-fa9371f1917c","500":"0866f505-a990-4a5e-80d5-a83fc6bf3ee8","503":"964b6b12-23cd-4462-9aff-841df61b330c"},"method":"post","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/batch","baseUrlOptions":["https://api.vaquill.ai"],"title":"Get many state session laws at once, by id or citation","codeSamples":[],"requestExampleLanguages":["bash","python","javascript","go"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.ids.items.0":"SSL_MN_2025R_G_Y2025_C1","body.ids.items.1":"S.F.No. 1552","body.ids.items.2":"SSL_MN_1801R_G_Y1801_C9999","body.jurisdiction.oneOf.0":"mn","body.includeBody":true}]},"dependencies":{"parameters":{"e9c4fb5d-e130-49ca-b161-4cf964fb8e10":{"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."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"ids":{"items":{"type":"string","uniqueKey":"ids.items.[INDEX]","typeLabel":"string"},"type":"array","maxItems":200,"minItems":1,"title":"Ids","description":"State session law ids, or citations, to read: up to 50 DISTINCT entries per call. Each entry is read exactly as the `{sessionLawId}` path of `GET /us/session-laws/{sessionLawId}` reads one: an id as sent, an id carrying copy damage, or a citation (`Minn. Laws 2025, ch. 1`, `P.A. 104-0001`, `S.F.No. 1552`). Entries are trimmed, and blank ones are dropped. Duplicates collapse FIRST (the first spelling wins, order is kept) and the cap applies to what is left, so a list quoting one law sixty times is one entry; `deduped` says how many were collapsed. 200 is the ceiling on the raw list. An entry is at most 300 characters. Federal ids (`SAL_...`) and endpoint names are misses, never charged. A CITATION also pays the resolve price (2 credits) whether it resolves or not, because the lookup is the verdict: an unresolved, ambiguous or state-less citation keeps it. It is refunded only when the session is partly collected or we failed. An id never pays it.","examples":[["SSL_MN_2025R_G_Y2025_C1","S.F.No. 1552","SSL_MN_1801R_G_Y1801_C9999"]],"isRequired":true,"uniqueKey":"ids","typeLabel":"string[]"},"jurisdiction":{"oneOf":[{"type":"string","title":"Jurisdiction","description":"Optional two-letter state code that scopes how a CITATION in `ids` is read, for the whole batch: it supplies the state a citation does not name (`Laws 2025, ch. 1` with `mn` is Minnesota's) and vetoes a state the citation does name or whose form belongs to another. Ignored for an id. The 50 states, `dc` and `pr`, case-insensitive; `federal` or an unknown code is a 422 and nothing is charged. Omit it for a batch whose citations each name their own state.","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"],"example":"mn","uniqueKey":"jurisdiction.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","title":"Jurisdiction","description":"Optional two-letter state code that scopes how a CITATION in `ids` is read, for the whole batch: it supplies the state a citation does not name (`Laws 2025, ch. 1` with `mn` is Minnesota's) and vetoes a state the citation does name or whose form belongs to another. Ignored for an id. The 50 states, `dc` and `pr`, case-insensitive; `federal` or an unknown code is a 422 and nothing is charged. Omit it for a batch whose citations each name their own state.","example":"mn","uniqueKey":"jurisdiction.oneOf.1","typeLabel":"null"}],"uniqueKey":"jurisdiction","typeLabel":"enum\u003cstring> | null"},"includeBody":{"type":"boolean","title":"Includebody","description":"Return the FIRST page of each served law's text inline, on `body`, beside the record. A page is about 30,000 characters and costs the ordinary body price (6 credits) per law whose page is served; a law whose text is withheld, not held or empty comes back with `body: null` and is not charged for it. Read `creditsConsumed` rather than computing the total: the worst case is 50 laws at 2 + 6 credits each. `bodyNextCursor` continues a longer act on `GET /us/session-laws/{sessionLawId}/body`.","default":false,"examples":[true],"uniqueKey":"includeBody","typeLabel":"boolean"}},"additionalProperties":false,"type":"object","required":["ids"],"title":"SessionLawBatchRequest","description":"Batch read. See `POST /us/session-laws/batch`.","uniqueKey":"","typeLabel":"SessionLawBatchRequest ยท object"},"examples":{"Example":{"title":"Example","value":{"ids":["SSL_MN_2025R_G_Y2025_C1","S.F.No. 1552","SSL_MN_1801R_G_Y1801_C9999"],"jurisdiction":"mn","includeBody":true}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"fd4496f2-a471-4791-90b3-d24804bc0d45":{"description":"One entry per distinct id or citation: the served laws in `laws`, every other entry in `notFound` with its status and reason. Not every entry is a law: read `notFound`, and `creditsConsumed` for what was billed.","content":{"application/json":{"schema":{"properties":{"laws":{"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":"laws.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":"laws.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":"laws.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":"laws.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":"laws.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":"laws.items.[INDEX].session.label.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.items.[INDEX].session.label","typeLabel":"string | null"},"type":{"oneOf":[{"type":"string","title":"Type","description":"`regular`, `special`, `extraordinary`, `fiscal`, `veto` or `unknown`.","example":"regular","uniqueKey":"laws.items.[INDEX].session.type.oneOf.0","typeLabel":"string"},{"type":"null","title":"Type","description":"`regular`, `special`, `extraordinary`, `fiscal`, `veto` or `unknown`.","example":"regular","uniqueKey":"laws.items.[INDEX].session.type.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.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":"laws.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":"laws.items.[INDEX].session.year.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.items.[INDEX].session.year","typeLabel":"integer | null"},"coverageStatus":{"oneOf":[{"type":"string","title":"Coveragestatus","description":"Whether we hold every law of this session. `complete`: every law the publisher lists for the session is accounted for, so a law absent from the list does not exist. `partial`: the collection of the session stopped short, so a law that is not found may exist, and this law's neighbours may be missing. The same verdict, with the counts behind it, is in the `sessionLaws` block on `GET /us/statutes/coverage`. Omitted when it cannot be read.","enum":["complete","partial"],"example":"complete","uniqueKey":"laws.items.[INDEX].session.coverageStatus.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","title":"Coveragestatus","description":"Whether we hold every law of this session. `complete`: every law the publisher lists for the session is accounted for, so a law absent from the list does not exist. `partial`: the collection of the session stopped short, so a law that is not found may exist, and this law's neighbours may be missing. The same verdict, with the counts behind it, is in the `sessionLaws` block on `GET /us/statutes/coverage`. Omitted when it cannot be read.","example":"complete","uniqueKey":"laws.items.[INDEX].session.coverageStatus.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.items.[INDEX].session.coverageStatus","typeLabel":"enum\u003cstring> | null"}},"type":"object","required":["code"],"title":"SessionLawDetailSession","description":"The legislative session the law was enacted in, and whether we hold all of it (`coverageStatus`).","isRequired":true,"uniqueKey":"laws.items.[INDEX].session","typeLabel":"SessionLawDetailSession ยท 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":"laws.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":"laws.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":"laws.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":"laws.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":"laws.items.[INDEX].identityConfidence","typeLabel":"string"},"input":{"type":"string","title":"Input","description":"The entry of your `ids` this law answers, exactly as you sent it (trimmed). When two entries name the same law, the law appears once, under the first.","examples":["S.F.No. 1552"],"isRequired":true,"uniqueKey":"laws.items.[INDEX].input","typeLabel":"string"},"status":{"type":"string","enum":["resolved","not_held"],"title":"Status","description":"`resolved`: the law is in the registry and its text status is `held`, `withheld` or `pending`. `not_held`: the registry knows the law exists and we hold no text (`textStatus: not_held`); the record is still served, and charged like any other, because it is the answer the lookup was for.","examples":["resolved"],"isRequired":true,"uniqueKey":"laws.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"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":"laws.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":"laws.items.[INDEX].lawId.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.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":"laws.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":"laws.items.[INDEX].citableAs.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.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":"laws.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":"laws.items.[INDEX].citationShort.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.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":"laws.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":"laws.items.[INDEX].number.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.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":"laws.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":"laws.items.[INDEX].billKey.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.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":"laws.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":"laws.items.[INDEX].billNumber.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.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":"laws.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":"laws.items.[INDEX].numberingYear.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.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":"laws.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":"laws.items.[INDEX].title.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.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":"laws.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":"laws.items.[INDEX].shortTitle.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.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":"laws.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":"laws.items.[INDEX].approvedDate.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.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":"laws.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":"laws.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":"laws.items.[INDEX].effectiveFirst.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.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":"laws.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":"laws.items.[INDEX].effectiveLast.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.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":"laws.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":"laws.items.[INDEX].isLaw.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.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":"laws.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":"laws.items.[INDEX].withheldReason.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.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":"laws.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":"laws.items.[INDEX].charCount.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.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":"laws.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":"laws.items.[INDEX].estimatedBodyPages.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.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":"laws.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":"laws.items.[INDEX].textSha256.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.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":"laws.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":"laws.items.[INDEX].versionNo.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.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":"laws.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":"laws.items.[INDEX].amendatoryMarkup.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.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":"laws.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":"laws.items.[INDEX].markupConvention.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.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":"laws.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":"laws.items.[INDEX].documentKind.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.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":"laws.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":"laws.items.[INDEX].officialUrl.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.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":"laws.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":"laws.items.[INDEX].officialUrlBasis.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.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":"laws.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":"laws.items.[INDEX].licenseNote.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.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":"laws.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":"laws.items.[INDEX].updatedAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.items.[INDEX].updatedAt","typeLabel":"string | null"},"citationAsPrinted":{"oneOf":[{"type":"string","title":"Citationasprinted","description":"The citation exactly as the publisher prints it. Null when none is printed.","example":"CHAPTER 1--S.F.No. 1552","uniqueKey":"laws.items.[INDEX].citationAsPrinted.oneOf.0","typeLabel":"string"},{"type":"null","title":"Citationasprinted","description":"The citation exactly as the publisher prints it. Null when none is printed.","example":"CHAPTER 1--S.F.No. 1552","uniqueKey":"laws.items.[INDEX].citationAsPrinted.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.items.[INDEX].citationAsPrinted","typeLabel":"string | null"},"vetoStatusAsPrinted":{"oneOf":[{"type":"string","title":"Vetostatusasprinted","description":"The publisher's own words on the governor's action. `enactmentOutcome` is our normalised reading of it.","example":"Signed by the governor March 17, 2025, 10:54 a.m.","uniqueKey":"laws.items.[INDEX].vetoStatusAsPrinted.oneOf.0","typeLabel":"string"},{"type":"null","title":"Vetostatusasprinted","description":"The publisher's own words on the governor's action. `enactmentOutcome` is our normalised reading of it.","example":"Signed by the governor March 17, 2025, 10:54 a.m.","uniqueKey":"laws.items.[INDEX].vetoStatusAsPrinted.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.items.[INDEX].vetoStatusAsPrinted","typeLabel":"string | null"},"pageCount":{"oneOf":[{"type":"integer","title":"Pagecount","description":"Pages in the source document when it is a PDF. Null for HTML sources.","example":162,"uniqueKey":"laws.items.[INDEX].pageCount.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Pagecount","description":"Pages in the source document when it is a PDF. Null for HTML sources.","example":162,"uniqueKey":"laws.items.[INDEX].pageCount.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.items.[INDEX].pageCount","typeLabel":"integer | null"},"sourceUrl":{"oneOf":[{"type":"string","title":"Sourceurl","description":"The official page or file the act's text was collected from, on a government publisher's host: the first `sources` entry whose `role` is `text` and whose `hostClass` is `gov`. Open it to verify the text against the publisher. Null when we hold no such source (a law we know exists and have not collected) or when the text source is not a government host. Present on a withheld law too: the official copy is always where to go when we hold the text back.","example":"https://www.revisor.mn.gov/laws/2025/0/Session+Law/Chapter/1/","uniqueKey":"laws.items.[INDEX].sourceUrl.oneOf.0","typeLabel":"string"},{"type":"null","title":"Sourceurl","description":"The official page or file the act's text was collected from, on a government publisher's host: the first `sources` entry whose `role` is `text` and whose `hostClass` is `gov`. Open it to verify the text against the publisher. Null when we hold no such source (a law we know exists and have not collected) or when the text source is not a government host. Present on a withheld law too: the official copy is always where to go when we hold the text back.","example":"https://www.revisor.mn.gov/laws/2025/0/Session+Law/Chapter/1/","uniqueKey":"laws.items.[INDEX].sourceUrl.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.items.[INDEX].sourceUrl","typeLabel":"string | null"},"effectiveDates":{"items":{"properties":{"kind":{"oneOf":[{"type":"string","title":"Kind","description":"What the date is, on `otherDates`: `approved`, `filed` or `other` (`kindAsPrinted` carries the publisher's label for `other`). Null on `effectiveDates`, where every entry is an effective date.","example":"approved","uniqueKey":"laws.items.[INDEX].effectiveDates.items.[INDEX].kind.oneOf.0","typeLabel":"string"},{"type":"null","title":"Kind","description":"What the date is, on `otherDates`: `approved`, `filed` or `other` (`kindAsPrinted` carries the publisher's label for `other`). Null on `effectiveDates`, where every entry is an effective date.","example":"approved","uniqueKey":"laws.items.[INDEX].effectiveDates.items.[INDEX].kind.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.items.[INDEX].effectiveDates.items.[INDEX].kind","typeLabel":"string | null"},"date":{"oneOf":[{"type":"string","title":"Date","description":"The date as ISO 8601 when the printed text could be read as one. Null when the publisher's wording is not a calendar date.","format":"date","example":"2025-03-17","uniqueKey":"laws.items.[INDEX].effectiveDates.items.[INDEX].date.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","title":"Date","description":"The date as ISO 8601 when the printed text could be read as one. Null when the publisher's wording is not a calendar date.","example":"2025-03-17","uniqueKey":"laws.items.[INDEX].effectiveDates.items.[INDEX].date.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.items.[INDEX].effectiveDates.items.[INDEX].date","typeLabel":"string\u003cdate> | null"},"dateAsPrinted":{"oneOf":[{"type":"string","title":"Dateasprinted","description":"The date exactly as the publisher wrote it, including any time of day.","example":"March 17, 2025, 10:54 a.m.","uniqueKey":"laws.items.[INDEX].effectiveDates.items.[INDEX].dateAsPrinted.oneOf.0","typeLabel":"string"},{"type":"null","title":"Dateasprinted","description":"The date exactly as the publisher wrote it, including any time of day.","example":"March 17, 2025, 10:54 a.m.","uniqueKey":"laws.items.[INDEX].effectiveDates.items.[INDEX].dateAsPrinted.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.items.[INDEX].effectiveDates.items.[INDEX].dateAsPrinted","typeLabel":"string | null"},"kindAsPrinted":{"oneOf":[{"type":"string","title":"Kindasprinted","description":"The publisher's own label for what the date is, when it prints one.","example":"Presentment Date","uniqueKey":"laws.items.[INDEX].effectiveDates.items.[INDEX].kindAsPrinted.oneOf.0","typeLabel":"string"},{"type":"null","title":"Kindasprinted","description":"The publisher's own label for what the date is, when it prints one.","example":"Presentment Date","uniqueKey":"laws.items.[INDEX].effectiveDates.items.[INDEX].kindAsPrinted.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.items.[INDEX].effectiveDates.items.[INDEX].kindAsPrinted","typeLabel":"string | null"},"scopeAsPrinted":{"oneOf":[{"type":"string","title":"Scopeasprinted","description":"What the date applies to when it is not the whole act, as printed: an act can take effect in parts. Null when the date applies to the act as a whole.","example":"CCP ยง871.20.","uniqueKey":"laws.items.[INDEX].effectiveDates.items.[INDEX].scopeAsPrinted.oneOf.0","typeLabel":"string"},{"type":"null","title":"Scopeasprinted","description":"What the date applies to when it is not the whole act, as printed: an act can take effect in parts. Null when the date applies to the act as a whole.","example":"CCP ยง871.20.","uniqueKey":"laws.items.[INDEX].effectiveDates.items.[INDEX].scopeAsPrinted.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.items.[INDEX].effectiveDates.items.[INDEX].scopeAsPrinted","typeLabel":"string | null"}},"type":"object","title":"SessionLawDate","description":"One printed date on a session law.","uniqueKey":"laws.items.[INDEX].effectiveDates.items.[INDEX]","typeLabel":"SessionLawDate ยท object"},"type":"array","title":"Effectivedates","description":"Every effective date the publisher prints for the act, in printed order. Always a list, never null; empty when none is held. Empty does NOT mean the act is not in force: a date printed as a rule (`the day following final enactment`) or not printed in the publisher's metadata is not guessed, and the approval date is never substituted for it. An act can take effect in parts, so a date may carry a `scopeAsPrinted`.","examples":[[{"date":"2024-12-05","dateAsPrinted":"December 5, 2024"}],[{"date":"2025-04-02","dateAsPrinted":"2025-04-02 00:00:00","scopeAsPrinted":"CCP ยง871.20."}],[]],"uniqueKey":"laws.items.[INDEX].effectiveDates","typeLabel":"SessionLawDate ยท object[]"},"otherDates":{"items":{"properties":{"kind":{"oneOf":[{"type":"string","title":"Kind","description":"What the date is, on `otherDates`: `approved`, `filed` or `other` (`kindAsPrinted` carries the publisher's label for `other`). Null on `effectiveDates`, where every entry is an effective date.","example":"approved","uniqueKey":"laws.items.[INDEX].otherDates.items.[INDEX].kind.oneOf.0","typeLabel":"string"},{"type":"null","title":"Kind","description":"What the date is, on `otherDates`: `approved`, `filed` or `other` (`kindAsPrinted` carries the publisher's label for `other`). Null on `effectiveDates`, where every entry is an effective date.","example":"approved","uniqueKey":"laws.items.[INDEX].otherDates.items.[INDEX].kind.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.items.[INDEX].otherDates.items.[INDEX].kind","typeLabel":"string | null"},"date":{"oneOf":[{"type":"string","title":"Date","description":"The date as ISO 8601 when the printed text could be read as one. Null when the publisher's wording is not a calendar date.","format":"date","example":"2025-03-17","uniqueKey":"laws.items.[INDEX].otherDates.items.[INDEX].date.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","title":"Date","description":"The date as ISO 8601 when the printed text could be read as one. Null when the publisher's wording is not a calendar date.","example":"2025-03-17","uniqueKey":"laws.items.[INDEX].otherDates.items.[INDEX].date.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.items.[INDEX].otherDates.items.[INDEX].date","typeLabel":"string\u003cdate> | null"},"dateAsPrinted":{"oneOf":[{"type":"string","title":"Dateasprinted","description":"The date exactly as the publisher wrote it, including any time of day.","example":"March 17, 2025, 10:54 a.m.","uniqueKey":"laws.items.[INDEX].otherDates.items.[INDEX].dateAsPrinted.oneOf.0","typeLabel":"string"},{"type":"null","title":"Dateasprinted","description":"The date exactly as the publisher wrote it, including any time of day.","example":"March 17, 2025, 10:54 a.m.","uniqueKey":"laws.items.[INDEX].otherDates.items.[INDEX].dateAsPrinted.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.items.[INDEX].otherDates.items.[INDEX].dateAsPrinted","typeLabel":"string | null"},"kindAsPrinted":{"oneOf":[{"type":"string","title":"Kindasprinted","description":"The publisher's own label for what the date is, when it prints one.","example":"Presentment Date","uniqueKey":"laws.items.[INDEX].otherDates.items.[INDEX].kindAsPrinted.oneOf.0","typeLabel":"string"},{"type":"null","title":"Kindasprinted","description":"The publisher's own label for what the date is, when it prints one.","example":"Presentment Date","uniqueKey":"laws.items.[INDEX].otherDates.items.[INDEX].kindAsPrinted.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.items.[INDEX].otherDates.items.[INDEX].kindAsPrinted","typeLabel":"string | null"},"scopeAsPrinted":{"oneOf":[{"type":"string","title":"Scopeasprinted","description":"What the date applies to when it is not the whole act, as printed: an act can take effect in parts. Null when the date applies to the act as a whole.","example":"CCP ยง871.20.","uniqueKey":"laws.items.[INDEX].otherDates.items.[INDEX].scopeAsPrinted.oneOf.0","typeLabel":"string"},{"type":"null","title":"Scopeasprinted","description":"What the date applies to when it is not the whole act, as printed: an act can take effect in parts. Null when the date applies to the act as a whole.","example":"CCP ยง871.20.","uniqueKey":"laws.items.[INDEX].otherDates.items.[INDEX].scopeAsPrinted.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.items.[INDEX].otherDates.items.[INDEX].scopeAsPrinted","typeLabel":"string | null"}},"type":"object","title":"SessionLawDate","description":"One printed date on a session law.","uniqueKey":"laws.items.[INDEX].otherDates.items.[INDEX]","typeLabel":"SessionLawDate ยท object"},"type":"array","title":"Otherdates","description":"Every other date printed on the act, each with its `kind`: the approval date, filing dates and the publisher's own milestones (presentment to the governor).","examples":[[{"date":"2025-03-17","dateAsPrinted":"March 17, 2025, 10:54 a.m.","kind":"approved"},{"date":"2025-03-14","dateAsPrinted":"March 14, 2025","kind":"other","kindAsPrinted":"Presentment Date"}]],"uniqueKey":"laws.items.[INDEX].otherDates","typeLabel":"SessionLawDate ยท object[]"},"codeSectionsAffected":{"items":{"properties":{"sectionAsPrinted":{"type":"string","title":"Sectionasprinted","description":"The code section the act changes, as the publisher's table prints it. Not normalised and not linked to an `actId` on `/us/statutes`.","examples":["19.27A.020"],"isRequired":true,"uniqueKey":"laws.items.[INDEX].codeSectionsAffected.items.[INDEX].sectionAsPrinted","typeLabel":"string"},"actionAsPrinted":{"oneOf":[{"type":"string","title":"Actionasprinted","description":"What the act does to that section, in the publisher's own words or abbreviation (`AMD` amended, `ADD`, `REP`, ...).","example":"AMD","uniqueKey":"laws.items.[INDEX].codeSectionsAffected.items.[INDEX].actionAsPrinted.oneOf.0","typeLabel":"string"},{"type":"null","title":"Actionasprinted","description":"What the act does to that section, in the publisher's own words or abbreviation (`AMD` amended, `ADD`, `REP`, ...).","example":"AMD","uniqueKey":"laws.items.[INDEX].codeSectionsAffected.items.[INDEX].actionAsPrinted.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.items.[INDEX].codeSectionsAffected.items.[INDEX].actionAsPrinted","typeLabel":"string | null"},"codeAsPrinted":{"oneOf":[{"type":"string","title":"Codeasprinted","description":"The code the section belongs to, as printed.","example":"RCW","uniqueKey":"laws.items.[INDEX].codeSectionsAffected.items.[INDEX].codeAsPrinted.oneOf.0","typeLabel":"string"},{"type":"null","title":"Codeasprinted","description":"The code the section belongs to, as printed.","example":"RCW","uniqueKey":"laws.items.[INDEX].codeSectionsAffected.items.[INDEX].codeAsPrinted.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.items.[INDEX].codeSectionsAffected.items.[INDEX].codeAsPrinted","typeLabel":"string | null"},"actSectionAsPrinted":{"oneOf":[{"type":"string","title":"Actsectionasprinted","description":"The section of the act itself that makes the change.","example":"6","uniqueKey":"laws.items.[INDEX].codeSectionsAffected.items.[INDEX].actSectionAsPrinted.oneOf.0","typeLabel":"string"},{"type":"null","title":"Actsectionasprinted","description":"The section of the act itself that makes the change.","example":"6","uniqueKey":"laws.items.[INDEX].codeSectionsAffected.items.[INDEX].actSectionAsPrinted.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.items.[INDEX].codeSectionsAffected.items.[INDEX].actSectionAsPrinted","typeLabel":"string | null"}},"type":"object","required":["sectionAsPrinted"],"title":"CodeSectionAffected","description":"A code section the publisher lists the act as affecting.","uniqueKey":"laws.items.[INDEX].codeSectionsAffected.items.[INDEX]","typeLabel":"CodeSectionAffected ยท object"},"type":"array","title":"Codesectionsaffected","description":"The code sections the publisher's own table lists the act as affecting, as printed. Always a list. Empty when the publisher prints no such table, which is common: the title still names sections in prose. We do not read sections out of the act text into this list.","examples":[[{"actSectionAsPrinted":"6","actionAsPrinted":"AMD","codeAsPrinted":"RCW","sectionAsPrinted":"19.27A.020"}],[]],"uniqueKey":"laws.items.[INDEX].codeSectionsAffected","typeLabel":"CodeSectionAffected ยท object[]"},"sources":{"items":{"properties":{"sourceIndex":{"type":"integer","title":"Sourceindex","description":"Position of this source in the law's source list, starting at 0.","examples":[0],"isRequired":true,"uniqueKey":"laws.items.[INDEX].sources.items.[INDEX].sourceIndex","typeLabel":"integer"},"role":{"oneOf":[{"type":"string","title":"Role","description":"What this document supplied: `text` (the act itself), `identity` (the publisher page that lists and numbers the session's laws), `metadata` (dates, veto and status tables), `code_sections` or `certified_image`.","example":"text","uniqueKey":"laws.items.[INDEX].sources.items.[INDEX].role.oneOf.0","typeLabel":"string"},{"type":"null","title":"Role","description":"What this document supplied: `text` (the act itself), `identity` (the publisher page that lists and numbers the session's laws), `metadata` (dates, veto and status tables), `code_sections` or `certified_image`.","example":"text","uniqueKey":"laws.items.[INDEX].sources.items.[INDEX].role.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.items.[INDEX].sources.items.[INDEX].role","typeLabel":"string | null"},"url":{"oneOf":[{"type":"string","title":"Url","description":"The publisher's URL for this document, as we fetched it. Null when the document did not come from a government publisher (`hostClass` `other`) and its host is not one we publish a link to: the document is still archived and `sha256` still describes it, but no link to a third-party host is served.","example":"https://www.revisor.mn.gov/laws/2025/0/Session+Law/Chapter/1/","uniqueKey":"laws.items.[INDEX].sources.items.[INDEX].url.oneOf.0","typeLabel":"string"},{"type":"null","title":"Url","description":"The publisher's URL for this document, as we fetched it. Null when the document did not come from a government publisher (`hostClass` `other`) and its host is not one we publish a link to: the document is still archived and `sha256` still describes it, but no link to a third-party host is served.","example":"https://www.revisor.mn.gov/laws/2025/0/Session+Law/Chapter/1/","uniqueKey":"laws.items.[INDEX].sources.items.[INDEX].url.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.items.[INDEX].sources.items.[INDEX].url","typeLabel":"string | null"},"fetchedAt":{"oneOf":[{"type":"string","title":"Fetchedat","description":"When we fetched the document, ISO 8601 UTC with a `+00:00` offset.","example":"2026-09-29T00:41:01+00:00","uniqueKey":"laws.items.[INDEX].sources.items.[INDEX].fetchedAt.oneOf.0","typeLabel":"string"},{"type":"null","title":"Fetchedat","description":"When we fetched the document, ISO 8601 UTC with a `+00:00` offset.","example":"2026-09-29T00:41:01+00:00","uniqueKey":"laws.items.[INDEX].sources.items.[INDEX].fetchedAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.items.[INDEX].sources.items.[INDEX].fetchedAt","typeLabel":"string | null"},"contentType":{"oneOf":[{"type":"string","title":"Contenttype","description":"The document's media type as the publisher served it.","example":"text/html; charset=utf-8","uniqueKey":"laws.items.[INDEX].sources.items.[INDEX].contentType.oneOf.0","typeLabel":"string"},{"type":"null","title":"Contenttype","description":"The document's media type as the publisher served it.","example":"text/html; charset=utf-8","uniqueKey":"laws.items.[INDEX].sources.items.[INDEX].contentType.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.items.[INDEX].sources.items.[INDEX].contentType","typeLabel":"string | null"},"sha256":{"oneOf":[{"type":"string","title":"Sha256","description":"SHA-256 (hex) of the exact bytes we fetched and archived.","example":"6c83d9c109c1ec61fcd96cea92c8c48414df7ae7dfda7452ebcfbddc181b6b45","uniqueKey":"laws.items.[INDEX].sources.items.[INDEX].sha256.oneOf.0","typeLabel":"string"},{"type":"null","title":"Sha256","description":"SHA-256 (hex) of the exact bytes we fetched and archived.","example":"6c83d9c109c1ec61fcd96cea92c8c48414df7ae7dfda7452ebcfbddc181b6b45","uniqueKey":"laws.items.[INDEX].sources.items.[INDEX].sha256.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.items.[INDEX].sources.items.[INDEX].sha256","typeLabel":"string | null"},"byteLength":{"oneOf":[{"type":"integer","title":"Bytelength","description":"Size of the fetched document in bytes.","example":69907,"uniqueKey":"laws.items.[INDEX].sources.items.[INDEX].byteLength.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Bytelength","description":"Size of the fetched document in bytes.","example":69907,"uniqueKey":"laws.items.[INDEX].sources.items.[INDEX].byteLength.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.items.[INDEX].sources.items.[INDEX].byteLength","typeLabel":"integer | null"},"hostClass":{"oneOf":[{"type":"string","title":"Hostclass","description":"`gov` when the document comes from a government publisher (including an official publisher on a non-`.gov` host), otherwise `other`.","example":"gov","uniqueKey":"laws.items.[INDEX].sources.items.[INDEX].hostClass.oneOf.0","typeLabel":"string"},{"type":"null","title":"Hostclass","description":"`gov` when the document comes from a government publisher (including an official publisher on a non-`.gov` host), otherwise `other`.","example":"gov","uniqueKey":"laws.items.[INDEX].sources.items.[INDEX].hostClass.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.items.[INDEX].sources.items.[INDEX].hostClass","typeLabel":"string | null"}},"type":"object","required":["sourceIndex"],"title":"SessionLawSource","description":"A document the record was collected from.","uniqueKey":"laws.items.[INDEX].sources.items.[INDEX]","typeLabel":"SessionLawSource ยท object"},"type":"array","title":"Sources","description":"The publisher documents the record was collected from, with the hash and fetch time of each: the audit trail from this response back to the official copy.","examples":[[{"byteLength":69907,"contentType":"text/html; charset=utf-8","fetchedAt":"2026-09-29T00:41:01Z","hostClass":"gov","role":"text","sha256":"6c83d9c109c1ec61fcd96cea92c8c48414df7ae7dfda7452ebcfbddc181b6b45","sourceIndex":0,"url":"https://www.revisor.mn.gov/laws/2025/0/Session+Law/Chapter/1/"}]],"uniqueKey":"laws.items.[INDEX].sources","typeLabel":"SessionLawSource ยท object[]"},"publisher":{"oneOf":[{"type":"object","title":"SessionLawPublisher","description":"What the publisher itself printed or published about the act, beyond the dates and citation above: its own structured fields verbatim (`publisherFields`: the bill's action history, committees, sponsors, and vote counts where the publisher gives them), its own identifiers, the legislature number and the printed pages. Omitted, not null, when it cannot be read or we only know the act exists.","properties":{"legislatureNumber":{"oneOf":[{"type":"integer","title":"Legislaturenumber","description":"The number of the legislature that enacted the act, as the publisher counts them (Minnesota's 94th Legislature, Alaska's 34th). Null where the publisher does not number its legislatures on the act's own pages; a gap in what we hold, not a fact about the act.","example":94,"uniqueKey":"laws.items.[INDEX].publisher.oneOf.0.legislatureNumber.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Legislaturenumber","description":"The number of the legislature that enacted the act, as the publisher counts them (Minnesota's 94th Legislature, Alaska's 34th). Null where the publisher does not number its legislatures on the act's own pages; a gap in what we hold, not a fact about the act.","example":94,"uniqueKey":"laws.items.[INDEX].publisher.oneOf.0.legislatureNumber.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.items.[INDEX].publisher.oneOf.0.legislatureNumber","typeLabel":"integer | null"},"sessionLastYear":{"oneOf":[{"type":"integer","title":"Sessionlastyear","description":"The last calendar year of the session the act belongs to, for a session that spans two (the District of Columbia's Council Period 25 runs 2023 to 2024, California's regular session 2025 to 2026). Equal to `session.year` for a session inside one year.","example":2025,"uniqueKey":"laws.items.[INDEX].publisher.oneOf.0.sessionLastYear.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Sessionlastyear","description":"The last calendar year of the session the act belongs to, for a session that spans two (the District of Columbia's Council Period 25 runs 2023 to 2024, California's regular session 2025 to 2026). Equal to `session.year` for a session inside one year.","example":2025,"uniqueKey":"laws.items.[INDEX].publisher.oneOf.0.sessionLastYear.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.items.[INDEX].publisher.oneOf.0.sessionLastYear","typeLabel":"integer | null"},"printedPageStart":{"oneOf":[{"type":"string","title":"Printedpagestart","description":"The page number printed on the act's first page in the publisher's bound volume, as printed and therefore a string (`1`, `ix`, `42A`). Not the physical page of a PDF: see `provenance.volume`. Null where the act is not printed in a volume.","example":"1","uniqueKey":"laws.items.[INDEX].publisher.oneOf.0.printedPageStart.oneOf.0","typeLabel":"string"},{"type":"null","title":"Printedpagestart","description":"The page number printed on the act's first page in the publisher's bound volume, as printed and therefore a string (`1`, `ix`, `42A`). Not the physical page of a PDF: see `provenance.volume`. Null where the act is not printed in a volume.","example":"1","uniqueKey":"laws.items.[INDEX].publisher.oneOf.0.printedPageStart.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.items.[INDEX].publisher.oneOf.0.printedPageStart","typeLabel":"string | null"},"printedPageEnd":{"oneOf":[{"type":"string","title":"Printedpageend","description":"The page number printed on the act's last page, as printed. Null as above.","example":"1","uniqueKey":"laws.items.[INDEX].publisher.oneOf.0.printedPageEnd.oneOf.0","typeLabel":"string"},{"type":"null","title":"Printedpageend","description":"The page number printed on the act's last page, as printed. Null as above.","example":"1","uniqueKey":"laws.items.[INDEX].publisher.oneOf.0.printedPageEnd.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.items.[INDEX].publisher.oneOf.0.printedPageEnd","typeLabel":"string | null"},"documentKindAsPrinted":{"oneOf":[{"type":"string","title":"Documentkindasprinted","description":"The label the publisher's own document carries for what kind of text it is, exactly as printed: `Enrolled version` (Texas), `As Adopted`, `Pamphlet Law` (New Jersey), `As Enacted`, `slip copy of this session law`. Our normalised reading of it is `documentKind`. Null where the document prints none.","example":"Enrolled version","uniqueKey":"laws.items.[INDEX].publisher.oneOf.0.documentKindAsPrinted.oneOf.0","typeLabel":"string"},{"type":"null","title":"Documentkindasprinted","description":"The label the publisher's own document carries for what kind of text it is, exactly as printed: `Enrolled version` (Texas), `As Adopted`, `Pamphlet Law` (New Jersey), `As Enacted`, `slip copy of this session law`. Our normalised reading of it is `documentKind`. Null where the document prints none.","example":"Enrolled version","uniqueKey":"laws.items.[INDEX].publisher.oneOf.0.documentKindAsPrinted.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.items.[INDEX].publisher.oneOf.0.documentKindAsPrinted","typeLabel":"string | null"},"publisherIds":{"items":{"properties":{"name":{"type":"string","title":"Name","description":"The publisher's own label for the identifier, exactly as it prints or exposes it, so it is not a vocabulary: `RAT#` (South Carolina), `bill_id` (California), `num type=\"act\"` (District of Columbia), `BillNumber` (Maryland), `L.D.` (Maine).","examples":["RAT#","bill_id","num type=\"act\""],"isRequired":true,"uniqueKey":"laws.items.[INDEX].publisher.oneOf.0.publisherIds.items.[INDEX].name","typeLabel":"string"},"value":{"type":"string","title":"Value","description":"The identifier's value as the publisher gives it, always a string: `5`, `202520260SB26`, `25-5`, `HB0001`.","examples":["5","202520260SB26","25-5"],"isRequired":true,"uniqueKey":"laws.items.[INDEX].publisher.oneOf.0.publisherIds.items.[INDEX].value","typeLabel":"string"}},"type":"object","required":["name","value"],"title":"SessionLawPublisherId","description":"An identifier the publisher itself gives an act.","uniqueKey":"laws.items.[INDEX].publisher.oneOf.0.publisherIds.items.[INDEX]","typeLabel":"SessionLawPublisherId ยท object"},"type":"array","title":"Publisherids","description":"The identifiers the publisher itself gives the act, in the order it presents them: South Carolina's ratification number, California's `bill_id`, the District of Columbia's act and bill numbers, Maryland's `BillNumber`. Useful for joining to the publisher's own site or data. Which identifiers exist differs by state. Empty when the publisher exposes none.","examples":[[{"name":"RAT#","value":"5"}],[{"name":"num type=\"act\"","value":"25-5"}]],"uniqueKey":"laws.items.[INDEX].publisher.oneOf.0.publisherIds","typeLabel":"SessionLawPublisherId ยท object[]"},"otherCitations":{"items":{"type":"string","uniqueKey":"laws.items.[INDEX].publisher.oneOf.0.otherCitations.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Othercitations","description":"Other citations the publisher prints for the same act, each exactly as printed: `Act No. 1` beside `CHAPTER 1`, `A.L.2025, c.1`, `70 DCR 1863`, `D.C. Act 25-5`. They are accepted as citations on `GET /us/session-laws/{sessionLawId}`. Empty when the publisher prints one form only.","examples":[["Act No. 1"],["D.C. Act 25-5","70 DCR 1863"]],"uniqueKey":"laws.items.[INDEX].publisher.oneOf.0.otherCitations","typeLabel":"string[]"},"publisherFields":{"additionalProperties":true,"type":"object","title":"Publisherfields","description":"The publisher's own structured fields for this act, as the publisher states them and otherwise untouched: an object whose keys, nesting and values are the publisher's own words. The keys DIFFER BY STATE and are not normalised or renamed: Texas gives the bill's full action history with journal page numbers (`Actions`), Maryland the committees and the reading and hearing dates in each chamber, North Carolina and New Mexico a history that can carry vote counts, most states little more than the bill number and a sponsor. What a given state supplies is whatever its publisher printed; do not assume any key exists, and do not read a missing key as a fact about the act. Votes in particular are present only where a publisher printed them. A few values are the publisher's own HTML: treat every string as untrusted text and never render it unescaped. `{}` when the publisher printed no such fields. A value too large to serve is left out and its key named in `publisherFieldsOmitted`.","examples":[{"Actions":[{"Action Chamber":"E","Action Comment":"","Action Date":"04/23/2025","Action Description":"Effective on 9/1/25","Action Time":"","Journal Page Number":""},{"Action Chamber":"E","Action Comment":"","Action Date":"04/23/2025","Action Description":"Signed by the Governor","Action Time":"","Journal Page Number":"1441"},{"Action Chamber":"E","Action Comment":"","Action Date":"04/14/2025","Action Description":"Sent to the Governor","Action Time":"","Journal Page Number":"1265"}],"Bill":"14","Caption Version":"Enrolled","Chapter":"1","Last Action":"04/23/2025 E Effective on 9/1/25"},{"BillNumber":"HB0001","ChapterNumber":"CH0437","CommitteePrimaryOpposite":"Judicial Proceedings","CommitteePrimaryOrigin":"Environment and Transportation","CrossfileBillNumber":"SB0007","FirstReadingDateHouseOfOrigin":"2025-01-08","SponsorPrimary":"Delegate Ebersole","Status":"Approved by the Governor - Chapter 437","ThirdReadingActionHouseOfOrigin":"Passed","ThirdReadingDateHouseOfOrigin":"2025-02-27"},{"Bill":"S115","History":[{"Action":"Concurred In H Com Sub","Chamber":"Senate","Date":"2/26/2025","Documents":"None","Votes":"PASS: 46-2"},{"Action":"Passed 2nd Reading","Chamber":"House","Date":"2/25/2025","Documents":"None","Votes":"PASS: 93-23"}],"Session Law":"2025-1"}],"uniqueKey":"laws.items.[INDEX].publisher.oneOf.0.publisherFields","typeLabel":"Publisherfields ยท object"},"publisherFieldsOmitted":{"items":{"type":"string","uniqueKey":"laws.items.[INDEX].publisher.oneOf.0.publisherFieldsOmitted.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Publisherfieldsomitted","description":"Keys of `publisherFields` that exist on the record but were too large to serve inline (past 64 KiB of JSON the largest values are left out, whole, never cut). Typically a publisher's full-bill HTML copy, whose text is on the body route in any case. Empty when nothing was left out, which is almost always.","examples":[[],["currentBillHTML"]],"uniqueKey":"laws.items.[INDEX].publisher.oneOf.0.publisherFieldsOmitted","typeLabel":"string[]"}},"uniqueKey":"laws.items.[INDEX].publisher.oneOf.0","typeLabel":"SessionLawPublisher ยท object"},{"type":"null","description":"What the publisher itself printed or published about the act, beyond the dates and citation above: its own structured fields verbatim (`publisherFields`: the bill's action history, committees, sponsors, and vote counts where the publisher gives them), its own identifiers, the legislature number and the printed pages. Omitted, not null, when it cannot be read or we only know the act exists.","uniqueKey":"laws.items.[INDEX].publisher.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.items.[INDEX].publisher","typeLabel":"SessionLawPublisher ยท object | null"},"provenance":{"oneOf":[{"type":"object","title":"SessionLawProvenance","description":"How we came by the text (the extraction method, the bound volume it was cut from) and the collector's own `caveats` on the record. Omitted, not null, when it cannot be read or we only know the act exists.","properties":{"textMethod":{"oneOf":[{"type":"string","title":"Textmethod","description":"How the text was extracted from the publisher's document: `pdf_text_layer`, `html`, `xml`, `docx`, `doc`, or `none` when no text was extracted. An open list. `none` is the same fact as `textStatus: not_held` for a collected law.","example":"pdf_text_layer","uniqueKey":"laws.items.[INDEX].provenance.oneOf.0.textMethod.oneOf.0","typeLabel":"string"},{"type":"null","title":"Textmethod","description":"How the text was extracted from the publisher's document: `pdf_text_layer`, `html`, `xml`, `docx`, `doc`, or `none` when no text was extracted. An open list. `none` is the same fact as `textStatus: not_held` for a collected law.","example":"pdf_text_layer","uniqueKey":"laws.items.[INDEX].provenance.oneOf.0.textMethod.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.items.[INDEX].provenance.oneOf.0.textMethod","typeLabel":"string | null"},"pagesWithText":{"oneOf":[{"type":"integer","title":"Pageswithtext","description":"For a PDF, how many of its `pageCount` pages had a text layer to read. A figure below `pageCount` means some pages (a signature page, a scanned stamp) contributed no text. Null for a source that has no pages.","example":3,"uniqueKey":"laws.items.[INDEX].provenance.oneOf.0.pagesWithText.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Pageswithtext","description":"For a PDF, how many of its `pageCount` pages had a text layer to read. A figure below `pageCount` means some pages (a signature page, a scanned stamp) contributed no text. Null for a source that has no pages.","example":3,"uniqueKey":"laws.items.[INDEX].provenance.oneOf.0.pagesWithText.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.items.[INDEX].provenance.oneOf.0.pagesWithText","typeLabel":"integer | null"},"volume":{"oneOf":[{"type":"object","title":"SessionLawVolume","description":"Present only when the act's text was cut out of a bound volume of the session's laws rather than published on its own: the volume and the pages. Null otherwise.","required":["url","pageStart","pageEnd"],"properties":{"url":{"type":"string","title":"Url","description":"The publisher's URL of the whole volume (a PDF of every act of the session) that this act's text was cut from. A government host.","examples":["https://static.legmt.gov/Laws/MCA-Supplements/2025SessionLaws_VOL1_Updated.pdf"],"isRequired":true,"uniqueKey":"laws.items.[INDEX].provenance.oneOf.0.volume.oneOf.0.url","typeLabel":"string"},"pageStart":{"type":"integer","title":"Pagestart","description":"First physical page of the act in that volume, counted from 1 at the first page of the file. Not the page number printed on the page: see `publisher.printedPageStart` for that.","examples":[135],"isRequired":true,"uniqueKey":"laws.items.[INDEX].provenance.oneOf.0.volume.oneOf.0.pageStart","typeLabel":"integer"},"pageEnd":{"type":"integer","title":"Pageend","description":"Last physical page of the act in that volume, the same counting as `pageStart`.","examples":[135],"isRequired":true,"uniqueKey":"laws.items.[INDEX].provenance.oneOf.0.volume.oneOf.0.pageEnd","typeLabel":"integer"},"boundaryHeading":{"oneOf":[{"type":"string","title":"Boundaryheading","description":"The heading in the volume at which the act's text begins, which is how the cut was found. Null when none is recorded.","example":"CHAPTER NO. 1","uniqueKey":"laws.items.[INDEX].provenance.oneOf.0.volume.oneOf.0.boundaryHeading.oneOf.0","typeLabel":"string"},{"type":"null","title":"Boundaryheading","description":"The heading in the volume at which the act's text begins, which is how the cut was found. Null when none is recorded.","example":"CHAPTER NO. 1","uniqueKey":"laws.items.[INDEX].provenance.oneOf.0.volume.oneOf.0.boundaryHeading.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.items.[INDEX].provenance.oneOf.0.volume.oneOf.0.boundaryHeading","typeLabel":"string | null"}},"uniqueKey":"laws.items.[INDEX].provenance.oneOf.0.volume.oneOf.0","typeLabel":"SessionLawVolume ยท object"},{"type":"null","description":"Present only when the act's text was cut out of a bound volume of the session's laws rather than published on its own: the volume and the pages. Null otherwise.","uniqueKey":"laws.items.[INDEX].provenance.oneOf.0.volume.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.items.[INDEX].provenance.oneOf.0.volume","typeLabel":"SessionLawVolume ยท object | null"},"caveats":{"items":{"type":"string","uniqueKey":"laws.items.[INDEX].provenance.oneOf.0.caveats.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Caveats","description":"The collector's own remarks on this record, one string each, verbatim and in order. Most say something about the act or its text that a reader should know: where the chapter number came from when the act does not print one, that the publisher prints no strike-through so there is no amendatory markup to carry, that an effective date is the publisher's wording rather than a calendar date, that the text layer has kerning damage. Some are working notes about how the record was assembled and are published as written; they are free text for a person to read, not a vocabulary to branch on, and their wording can change. Notes that only describe how a page was fetched or decoded are not included. `[]` when there are none.","examples":[["Chapter number is from the publisher's Passed Legislation index ('Current Status'); the enrolled PDF prints a blank 'Chapter No. ____' field.","The 1-25 line-number column printed on every page is stripped."]],"uniqueKey":"laws.items.[INDEX].provenance.oneOf.0.caveats","typeLabel":"string[]"}},"uniqueKey":"laws.items.[INDEX].provenance.oneOf.0","typeLabel":"SessionLawProvenance ยท object"},{"type":"null","description":"How we came by the text (the extraction method, the bound volume it was cut from) and the collector's own `caveats` on the record. Omitted, not null, when it cannot be read or we only know the act exists.","uniqueKey":"laws.items.[INDEX].provenance.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.items.[INDEX].provenance","typeLabel":"SessionLawProvenance ยท object | null"},"extrasUnavailable":{"type":"boolean","title":"Extrasunavailable","description":"Present and `true` only when the read behind `publisher`, `provenance` and `session.coverageStatus` failed on this request. Those three are then absent because we could not read them, not because the act has none: repeat the request to get them. Omitted when the read succeeded.","default":false,"examples":[true],"uniqueKey":"laws.items.[INDEX].extrasUnavailable","typeLabel":"boolean"},"body":{"oneOf":[{"type":"string","title":"Body","description":"The first page of the law's text exactly as printed, present only when `includeBody` was true and the text is served. Null otherwise, and then not charged. Read `bodyHasMore` to know whether the act continues.","example":"CHAPTER 1--S.F.No. 1552\n\nAn act\n\nrelating to agriculture; ...","uniqueKey":"laws.items.[INDEX].body.oneOf.0","typeLabel":"string"},{"type":"null","title":"Body","description":"The first page of the law's text exactly as printed, present only when `includeBody` was true and the text is served. Null otherwise, and then not charged. Read `bodyHasMore` to know whether the act continues.","example":"CHAPTER 1--S.F.No. 1552\n\nAn act\n\nrelating to agriculture; ...","uniqueKey":"laws.items.[INDEX].body.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.items.[INDEX].body","typeLabel":"string | null"},"bodyPageEnd":{"oneOf":[{"type":"integer","title":"Bodypageend","description":"Character offset just past `body` in the full text: the first page starts at 0. Null when `body` is null.","example":5470,"uniqueKey":"laws.items.[INDEX].bodyPageEnd.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Bodypageend","description":"Character offset just past `body` in the full text: the first page starts at 0. Null when `body` is null.","example":5470,"uniqueKey":"laws.items.[INDEX].bodyPageEnd.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.items.[INDEX].bodyPageEnd","typeLabel":"integer | null"},"bodyTotalChars":{"oneOf":[{"type":"integer","title":"Bodytotalchars","description":"Length of the whole text in characters. Null when `body` is null.","example":5470,"uniqueKey":"laws.items.[INDEX].bodyTotalChars.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Bodytotalchars","description":"Length of the whole text in characters. Null when `body` is null.","example":5470,"uniqueKey":"laws.items.[INDEX].bodyTotalChars.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.items.[INDEX].bodyTotalChars","typeLabel":"integer | null"},"bodyHasMore":{"oneOf":[{"type":"boolean","title":"Bodyhasmore","description":"True when the text continues beyond `body`. Each further page is read, and charged, on `GET /us/session-laws/{sessionLawId}/body`. Null when `body` is null.","example":false,"uniqueKey":"laws.items.[INDEX].bodyHasMore.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Bodyhasmore","description":"True when the text continues beyond `body`. Each further page is read, and charged, on `GET /us/session-laws/{sessionLawId}/body`. Null when `body` is null.","example":false,"uniqueKey":"laws.items.[INDEX].bodyHasMore.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.items.[INDEX].bodyHasMore","typeLabel":"boolean | null"},"bodyNextCursor":{"oneOf":[{"type":"string","title":"Bodynextcursor","description":"Send as `cursor` to `GET /us/session-laws/{sessionLawId}/body` to read the next page of this law. Null on the last page, and when `body` is null.","example":null,"uniqueKey":"laws.items.[INDEX].bodyNextCursor.oneOf.0","typeLabel":"string"},{"type":"null","title":"Bodynextcursor","description":"Send as `cursor` to `GET /us/session-laws/{sessionLawId}/body` to read the next page of this law. Null on the last page, and when `body` is null.","example":null,"uniqueKey":"laws.items.[INDEX].bodyNextCursor.oneOf.1","typeLabel":"null"}],"uniqueKey":"laws.items.[INDEX].bodyNextCursor","typeLabel":"string | null"}},"type":"object","required":["sessionLawId","jurisdiction","citation","session","series","instrumentType","enactmentOutcome","textStatus","identityConfidence","input","status"],"title":"SessionLawBatchLaw","description":"One served law: the same record `GET /us/session-laws/{sessionLawId}` returns.","uniqueKey":"laws.items.[INDEX]","typeLabel":"SessionLawBatchLaw ยท object"},"type":"array","title":"Laws","description":"The served laws, one per distinct law, in the order the entries of `ids` first reached them. Entries that missed are NOT here, so a client mapping by position must use `input` on each law (or `notFound`), never the index.","uniqueKey":"laws","typeLabel":"SessionLawBatchLaw ยท object[]"},"resolved":{"items":{"properties":{"input":{"type":"string","title":"Input","description":"What you sent in the path, exactly.","examples":["S.F.No. 1552"],"isRequired":true,"uniqueKey":"resolved.items.[INDEX].input","typeLabel":"string"},"sessionLawId":{"type":"string","title":"Sessionlawid","description":"The id it resolved to. Send this next time to skip resolution and its fee.","examples":["SSL_MN_2025R_G_Y2025_C1"],"isRequired":true,"uniqueKey":"resolved.items.[INDEX].sessionLawId","typeLabel":"string"},"via":{"type":"string","enum":["normalized_id","citation","earlier_entry"],"title":"Via","description":"`citation`: your input was a citation and matched exactly one law's citation form. `normalized_id`: your input was an id carrying surrounding whitespace, quotes or a trailing period, which were removed. `earlier_entry` (batch only): your input was an id exactly as sent, but an earlier entry of `ids` already produced that law, so it appears once in `laws`.","examples":["citation"],"isRequired":true,"uniqueKey":"resolved.items.[INDEX].via","typeLabel":"enum\u003cstring>"},"matchedForm":{"oneOf":[{"type":"string","title":"Matchedform","description":"Which of the law's citation forms your input matched: `as_printed` (its printed citation), `bill` (its bill number) or `other_as_printed` (another printed form). Null for `normalized_id`.","example":"bill","uniqueKey":"resolved.items.[INDEX].matchedForm.oneOf.0","typeLabel":"string"},{"type":"null","title":"Matchedform","description":"Which of the law's citation forms your input matched: `as_printed` (its printed citation), `bill` (its bill number) or `other_as_printed` (another printed form). Null for `normalized_id`.","example":"bill","uniqueKey":"resolved.items.[INDEX].matchedForm.oneOf.1","typeLabel":"null"}],"uniqueKey":"resolved.items.[INDEX].matchedForm","typeLabel":"string | null"}},"type":"object","required":["input","sessionLawId","via"],"title":"SessionLawResolution","description":"How a citation sent in place of a `sessionLawId` was matched.","uniqueKey":"resolved.items.[INDEX]","typeLabel":"SessionLawResolution ยท object"},"type":"array","title":"Resolved","description":"One entry per input that did NOT match an id exactly as sent: a citation resolved to its law, or an id cleaned of whitespace, quotes or a trailing period. Includes an input whose law an earlier entry already produced, so every input is mappable onto `laws`. Empty when every entry was an exact id.","uniqueKey":"resolved","typeLabel":"SessionLawResolution ยท object[]"},"notFound":{"items":{"properties":{"input":{"type":"string","title":"Input","description":"The entry of your `ids`, exactly as you sent it (trimmed).","examples":["SSL_MN_1801R_G_Y1801_C9999"],"isRequired":true,"uniqueKey":"notFound.items.[INDEX].input","typeLabel":"string"},"status":{"type":"string","enum":["ambiguous","needs_jurisdiction","unparsed","session_not_fully_collected","not_found","federal","error"],"title":"Status","description":"`not_found`: no law carries this id (or it exists in another letter case, see `didYouMean`). `unparsed`: it reads as a citation and no state session law we hold carries it. `ambiguous`: the citation names several laws of one state, all in `didYouMean`, none chosen for you. `needs_jurisdiction`: the citation is in a form several states share and names none; `jurisdictions` lists where it exists. `session_not_fully_collected`: nothing matched and the session it points into is only partly collected, so the law may exist; `sessionCoverage` says how much we hold. `federal`: a federal act, served by `/us/statutes/section`. `error`: we failed to look this entry up; it is NOT a statement that the law does not exist, it is refunded in full, and it is safe to send again.","examples":["not_found"],"isRequired":true,"uniqueKey":"notFound.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"reason":{"type":"string","title":"Reason","description":"The finer reason, the same vocabulary as `reason` on the 404 of `GET /us/session-laws/{sessionLawId}`: `not_in_registry`, `wrong_case`, `unresolved_citation`, `ambiguous_citation`, `needs_jurisdiction`, `federal_session_law`, `missing_session_law_id`, `session_not_fully_collected`; or `lookup_failed` when `status` is `error`. Branch on `status`, which is the closed set; the wording of a reason can grow.","examples":["not_in_registry"],"isRequired":true,"uniqueKey":"notFound.items.[INDEX].reason","typeLabel":"string"},"detail":{"type":"string","title":"Detail","description":"A sentence safe to show a user, the same text the single route's 404 carries.","examples":["Session law not found. No law in the registry carries this id. Take ids from a /us/session-laws/list result, or send the citation in its place."],"isRequired":true,"uniqueKey":"notFound.items.[INDEX].detail","typeLabel":"string"},"didYouMean":{"items":{"type":"string","uniqueKey":"notFound.items.[INDEX].didYouMean.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Didyoumean","description":"Real `sessionLawId`s the entry points at: the one that exists in another case, or every law an ambiguous citation names (at most 20, the conventional reading first). Empty when nothing matched.","examples":[["SSL_KY_2025R_G_Y2025_C100","SSL_MO_2025R_G_Y2025_BHB2"]],"uniqueKey":"notFound.items.[INDEX].didYouMean","typeLabel":"string[]"},"defaultSessionLawId":{"oneOf":[{"type":"string","title":"Defaultsessionlawid","description":"On `ambiguous`, the conventional reading when the registry records one. Informational: it is never served for you.","example":null,"uniqueKey":"notFound.items.[INDEX].defaultSessionLawId.oneOf.0","typeLabel":"string"},{"type":"null","title":"Defaultsessionlawid","description":"On `ambiguous`, the conventional reading when the registry records one. Informational: it is never served for you.","example":null,"uniqueKey":"notFound.items.[INDEX].defaultSessionLawId.oneOf.1","typeLabel":"null"}],"uniqueKey":"notFound.items.[INDEX].defaultSessionLawId","typeLabel":"string | null"},"jurisdictions":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"notFound.items.[INDEX].jurisdictions.oneOf.0.items.[INDEX]","typeLabel":"string"},"title":"Jurisdictions","description":"On `needs_jurisdiction`, every state (lower-case postal code) where the citation exists. Name one in the citation, or send `jurisdiction`, and resend. Null otherwise.","example":["il","mn","tx"],"uniqueKey":"notFound.items.[INDEX].jurisdictions.oneOf.0","typeLabel":"string[]"},{"type":"null","title":"Jurisdictions","description":"On `needs_jurisdiction`, every state (lower-case postal code) where the citation exists. Name one in the citation, or send `jurisdiction`, and resend. Null otherwise.","example":["il","mn","tx"],"uniqueKey":"notFound.items.[INDEX].jurisdictions.oneOf.1","typeLabel":"null"}],"uniqueKey":"notFound.items.[INDEX].jurisdictions","typeLabel":"string[] | null"},"candidateCount":{"oneOf":[{"type":"integer","title":"Candidatecount","description":"On `ambiguous` and `needs_jurisdiction`, how many laws the citation names in all. When it exceeds `len(didYouMean)` the list is a sample. Null otherwise.","example":22,"uniqueKey":"notFound.items.[INDEX].candidateCount.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Candidatecount","description":"On `ambiguous` and `needs_jurisdiction`, how many laws the citation names in all. When it exceeds `len(didYouMean)` the list is a sample. Null otherwise.","example":22,"uniqueKey":"notFound.items.[INDEX].candidateCount.oneOf.1","typeLabel":"null"}],"uniqueKey":"notFound.items.[INDEX].candidateCount","typeLabel":"integer | null"},"truncated":{"oneOf":[{"type":"boolean","title":"Truncated","description":"True when `didYouMean` was capped and `candidateCount` is larger. Null otherwise.","example":true,"uniqueKey":"notFound.items.[INDEX].truncated.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Truncated","description":"True when `didYouMean` was capped and `candidateCount` is larger. Null otherwise.","example":true,"uniqueKey":"notFound.items.[INDEX].truncated.oneOf.1","typeLabel":"null"}],"uniqueKey":"notFound.items.[INDEX].truncated","typeLabel":"boolean | null"},"sessionCoverage":{"oneOf":[{"type":"object","title":"SessionLawSessionCoverage","description":"On `session_not_fully_collected`, the partly collected session the entry points into: how many laws we hold of how many it should have. Null otherwise.","required":["code","status","servedCount"],"properties":{"code":{"type":"string","title":"Code","description":"Session code, for example `2025R`.","examples":["2025R"],"isRequired":true,"uniqueKey":"notFound.items.[INDEX].sessionCoverage.oneOf.0.code","typeLabel":"string"},"status":{"type":"string","enum":["complete","partial"],"title":"Status","description":"`complete` when every law the publisher lists for the session is accounted for. Anything less is `partial`: a law missing from a partial session is not evidence that it does not exist, and asking for one by id or citation answers `session_not_fully_collected`, free of charge, rather than a plain not found.","examples":["complete"],"isRequired":true,"uniqueKey":"notFound.items.[INDEX].sessionCoverage.oneOf.0.status","typeLabel":"enum\u003cstring>"},"servedCount":{"type":"integer","minimum":0,"title":"Servedcount","description":"Laws from this session we serve: every one we answer for by id, citation or list, whether or not we hold its text (`notHeldCount` of them have none). Laws whose text is withheld are not counted here, they are `withheldCount`. `servedCount + withheldCount` is `registryCount`, less any law still being verified.","examples":[39],"isRequired":true,"uniqueKey":"notFound.items.[INDEX].sessionCoverage.oneOf.0.servedCount","typeLabel":"integer"},"label":{"oneOf":[{"type":"string","title":"Label","description":"The session's canonical label.","example":"2025 Regular Session","uniqueKey":"notFound.items.[INDEX].sessionCoverage.oneOf.0.label.oneOf.0","typeLabel":"string"},{"type":"null","title":"Label","description":"The session's canonical label.","example":"2025 Regular Session","uniqueKey":"notFound.items.[INDEX].sessionCoverage.oneOf.0.label.oneOf.1","typeLabel":"null"}],"uniqueKey":"notFound.items.[INDEX].sessionCoverage.oneOf.0.label","typeLabel":"string | null"},"type":{"oneOf":[{"type":"string","title":"Type","description":"`regular`, `special`, `extraordinary`, `fiscal`, `veto` or `unknown`.","example":"regular","uniqueKey":"notFound.items.[INDEX].sessionCoverage.oneOf.0.type.oneOf.0","typeLabel":"string"},{"type":"null","title":"Type","description":"`regular`, `special`, `extraordinary`, `fiscal`, `veto` or `unknown`.","example":"regular","uniqueKey":"notFound.items.[INDEX].sessionCoverage.oneOf.0.type.oneOf.1","typeLabel":"null"}],"uniqueKey":"notFound.items.[INDEX].sessionCoverage.oneOf.0.type","typeLabel":"string | null"},"year":{"oneOf":[{"type":"integer","title":"Year","description":"The year the session convened, the year `code` starts with.","example":2025,"uniqueKey":"notFound.items.[INDEX].sessionCoverage.oneOf.0.year.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Year","description":"The year the session convened, the year `code` starts with.","example":2025,"uniqueKey":"notFound.items.[INDEX].sessionCoverage.oneOf.0.year.oneOf.1","typeLabel":"null"}],"uniqueKey":"notFound.items.[INDEX].sessionCoverage.oneOf.0.year","typeLabel":"integer | null"},"withheldCount":{"type":"integer","minimum":0,"title":"Withheldcount","description":"Laws from this session we hold and list but whose text is withheld for a measured defect (`textStatus: withheld`). They are real laws: their records are served, their text is not.","default":0,"examples":[0],"uniqueKey":"notFound.items.[INDEX].sessionCoverage.oneOf.0.withheldCount","typeLabel":"integer"},"notHeldCount":{"type":"integer","minimum":0,"title":"Notheldcount","description":"Of the laws counted in `servedCount`, how many have no text held (`textStatus: not_held` or `pending`). A subset of `servedCount`, not an addition to it: do not add it to `servedCount` or `withheldCount`.","default":0,"examples":[0],"uniqueKey":"notFound.items.[INDEX].sessionCoverage.oneOf.0.notHeldCount","typeLabel":"integer"},"registryCount":{"type":"integer","minimum":0,"title":"Registrycount","description":"Every law of this session in our registry, whether or not its text is held: `servedCount + withheldCount`. Any difference is a law still being verified, which is neither.","default":0,"examples":[39],"uniqueKey":"notFound.items.[INDEX].sessionCoverage.oneOf.0.registryCount","typeLabel":"integer"},"collectedCount":{"type":"integer","minimum":0,"title":"Collectedcount","description":"Laws from this session whose text we have collected, served or withheld. Compare it with `denominator.value` to see how much of the session we hold.","default":0,"examples":[39],"uniqueKey":"notFound.items.[INDEX].sessionCoverage.oneOf.0.collectedCount","typeLabel":"integer"},"denominator":{"oneOf":[{"type":"object","title":"SessionLawDenominator","description":"How many laws the session is expected to hold, and where that figure comes from. Null when it could not be read.","required":["kind","derivation"],"example":{"derivation":"The publisher's complete listing of this session names 296 measures. We hold 43 of them; the rest are not yet collected.","kind":"complete_listing","value":296},"properties":{"kind":{"type":"string","enum":["stated_count","complete_listing","max_number","feed_total","our_recount","registry_union","none"],"title":"Kind","description":"Where the total comes from. `stated_count`: the publisher states how many measures the session enacted. `complete_listing`: the publisher's own complete list of the session's acts, which we counted. `max_number`: the highest chapter number the publisher printed. `feed_total`: the total a publisher feed reports. `our_recount`: we counted the publisher's pages ourselves. `registry_union`: the measures we know of from several sources. `none`: no total is available, so completeness cannot be judged.","examples":["complete_listing"],"isRequired":true,"uniqueKey":"notFound.items.[INDEX].sessionCoverage.oneOf.0.denominator.oneOf.0.kind","typeLabel":"enum\u003cstring>"},"derivation":{"type":"string","title":"Derivation","description":"One plain sentence saying what `value` counts and where it comes from. Written for customers: it never contains our internal audit or collection notes.","examples":["The publisher's complete listing of this session names 296 acts."],"isRequired":true,"uniqueKey":"notFound.items.[INDEX].sessionCoverage.oneOf.0.denominator.oneOf.0.derivation","typeLabel":"string"},"value":{"oneOf":[{"type":"integer","title":"Value","description":"The number of laws the session is expected to hold. Null when `kind` is `none`. Compare it with `registryCount` and `servedCount`.","minimum":0,"example":296,"uniqueKey":"notFound.items.[INDEX].sessionCoverage.oneOf.0.denominator.oneOf.0.value.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Value","description":"The number of laws the session is expected to hold. Null when `kind` is `none`. Compare it with `registryCount` and `servedCount`.","example":296,"uniqueKey":"notFound.items.[INDEX].sessionCoverage.oneOf.0.denominator.oneOf.0.value.oneOf.1","typeLabel":"null"}],"uniqueKey":"notFound.items.[INDEX].sessionCoverage.oneOf.0.denominator.oneOf.0.value","typeLabel":"integer | null"}},"uniqueKey":"notFound.items.[INDEX].sessionCoverage.oneOf.0.denominator.oneOf.0","typeLabel":"SessionLawDenominator ยท object"},{"type":"null","description":"How many laws the session is expected to hold, and where that figure comes from. Null when it could not be read.","example":{"derivation":"The publisher's complete listing of this session names 296 measures. We hold 43 of them; the rest are not yet collected.","kind":"complete_listing","value":296},"uniqueKey":"notFound.items.[INDEX].sessionCoverage.oneOf.0.denominator.oneOf.1","typeLabel":"null"}],"uniqueKey":"notFound.items.[INDEX].sessionCoverage.oneOf.0.denominator","typeLabel":"SessionLawDenominator ยท object | null"},"openGaps":{"type":"integer","minimum":0,"title":"Opengaps","description":"Laws the publisher lists for this session that we could not collect and have not yet. 0 on a `complete` session.","default":0,"examples":[0],"uniqueKey":"notFound.items.[INDEX].sessionCoverage.oneOf.0.openGaps","typeLabel":"integer"},"numberingHoles":{"oneOf":[{"type":"integer","title":"Numberingholes","description":"Numbers inside the session's printed range that carry no law, which may never have been issued; null when not measured, and never counted in `openGaps`.","minimum":0,"example":12,"uniqueKey":"notFound.items.[INDEX].sessionCoverage.oneOf.0.numberingHoles.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Numberingholes","description":"Numbers inside the session's printed range that carry no law, which may never have been issued; null when not measured, and never counted in `openGaps`.","example":12,"uniqueKey":"notFound.items.[INDEX].sessionCoverage.oneOf.0.numberingHoles.oneOf.1","typeLabel":"null"}],"uniqueKey":"notFound.items.[INDEX].sessionCoverage.oneOf.0.numberingHoles","typeLabel":"integer | null"},"denominatorStale":{"oneOf":[{"type":"boolean","title":"Denominatorstale","description":"True when our registry holds more laws than `denominator.value`, so the figure counts a narrower unit or is out of date and cannot measure what is missing; null when not assessed.","example":false,"uniqueKey":"notFound.items.[INDEX].sessionCoverage.oneOf.0.denominatorStale.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Denominatorstale","description":"True when our registry holds more laws than `denominator.value`, so the figure counts a narrower unit or is out of date and cannot measure what is missing; null when not assessed.","example":false,"uniqueKey":"notFound.items.[INDEX].sessionCoverage.oneOf.0.denominatorStale.oneOf.1","typeLabel":"null"}],"uniqueKey":"notFound.items.[INDEX].sessionCoverage.oneOf.0.denominatorStale","typeLabel":"boolean | null"},"measuredAt":{"oneOf":[{"type":"string","title":"Measuredat","description":"When this session's coverage was last measured, ISO 8601 UTC.","example":"2026-10-05T09:07:12+00:00","uniqueKey":"notFound.items.[INDEX].sessionCoverage.oneOf.0.measuredAt.oneOf.0","typeLabel":"string"},{"type":"null","title":"Measuredat","description":"When this session's coverage was last measured, ISO 8601 UTC.","example":"2026-10-05T09:07:12+00:00","uniqueKey":"notFound.items.[INDEX].sessionCoverage.oneOf.0.measuredAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"notFound.items.[INDEX].sessionCoverage.oneOf.0.measuredAt","typeLabel":"string | null"}},"uniqueKey":"notFound.items.[INDEX].sessionCoverage.oneOf.0","typeLabel":"SessionLawSessionCoverage ยท object"},{"type":"null","description":"On `session_not_fully_collected`, the partly collected session the entry points into: how many laws we hold of how many it should have. Null otherwise.","uniqueKey":"notFound.items.[INDEX].sessionCoverage.oneOf.1","typeLabel":"null"}],"uniqueKey":"notFound.items.[INDEX].sessionCoverage","typeLabel":"SessionLawSessionCoverage ยท object | null"}},"type":"object","required":["input","status","reason","detail"],"title":"SessionLawBatchMiss","description":"One entry of `ids` that did not yield a law, and why.","uniqueKey":"notFound.items.[INDEX]","typeLabel":"SessionLawBatchMiss ยท object"},"type":"array","title":"Notfound","description":"Every entry that did not yield a law, in the order sent, each with its `status` and `reason`. A miss is not charged for the route's own price. An entry read as a CITATION also paid the resolve price, kept whenever we gave a verdict on it (`unparsed`, `ambiguous`, `needs_jurisdiction`, `federal`) and refunded on `session_not_fully_collected` and `error`. An id pays no resolve price.","uniqueKey":"notFound","typeLabel":"SessionLawBatchMiss ยท object[]"},"count":{"type":"integer","title":"Count","description":"Number of laws returned in `laws`.","default":0,"examples":[2],"uniqueKey":"count","typeLabel":"integer"},"deduped":{"type":"integer","title":"Deduped","description":"How many entries of `ids` were collapsed because an earlier entry was identical after trimming. Zero when none were. Two DIFFERENT spellings of one law are not counted here: the law appears once in `laws` and both spellings are in `resolved`.","default":0,"examples":[0],"uniqueKey":"deduped","typeLabel":"integer"},"bodyNote":{"oneOf":[{"type":"string","title":"Bodynote","description":"Set only when `includeBody` was sent and the bodies were withheld for the whole call: either your balance could not cover them, or the charge for them could not be completed on our side. Either way no body was returned and none was charged, and the laws are intact. Absent otherwise.","example":null,"uniqueKey":"bodyNote.oneOf.0","typeLabel":"string"},{"type":"null","title":"Bodynote","description":"Set only when `includeBody` was sent and the bodies were withheld for the whole call: either your balance could not cover them, or the charge for them could not be completed on our side. Either way no body was returned and none was charged, and the laws are intact. Absent otherwise.","example":null,"uniqueKey":"bodyNote.oneOf.1","typeLabel":"null"}],"uniqueKey":"bodyNote","typeLabel":"string | null"},"creditsConsumed":{"type":"integer","title":"Creditsconsumed","description":"Credits actually charged for this call, never the list price: 2 per law served, plus the 2-credit resolve price for each citation whose resolution is kept, plus the body price per `body` served. Misses and failures bill nothing for the route.","default":0,"examples":[4],"uniqueKey":"creditsConsumed","typeLabel":"integer"},"processingTimeMs":{"type":"number","title":"Processingtimems","description":"Server-side time for this request in milliseconds, excluding network transit. Not billed on.","default":0,"examples":[512.3],"uniqueKey":"processingTimeMs","typeLabel":"number"}},"type":"object","title":"SessionLawBatchResponse","description":"Response for `POST /us/session-laws/batch`.","uniqueKey":"","typeLabel":"SessionLawBatchResponse ยท object"},"examples":{"ids":{"title":"ids","value":{"laws":[{"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,"coverageStatus":"complete"},"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","citationAsPrinted":"CHAPTER 1--S.F.No. 1552","vetoStatusAsPrinted":"Signed by the governor March 17, 2025, 10:54 a.m.","effectiveDates":[],"otherDates":[{"kind":"approved","date":"2025-03-17","dateAsPrinted":"March 17, 2025, 10:54 a.m."},{"kind":"other","date":"2025-03-14","dateAsPrinted":"March 14, 2025","kindAsPrinted":"Presentment Date"},{"kind":"other","date":"2025-03-14","dateAsPrinted":"March 14, 2025","kindAsPrinted":"Presented to the governor"}],"codeSectionsAffected":[],"sourceUrl":"https://www.revisor.mn.gov/laws/2025/0/Session+Law/Chapter/1/","sources":[{"sourceIndex":0,"role":"text","url":"https://www.revisor.mn.gov/laws/2025/0/Session+Law/Chapter/1/","fetchedAt":"2026-09-29T00:41:01+00:00","contentType":"text/html; charset=utf-8","sha256":"6c83d9c109c1ec61fcd96cea92c8c48414df7ae7dfda7452ebcfbddc181b6b45","byteLength":69907,"hostClass":"gov"},{"sourceIndex":1,"role":"identity","url":"https://www.revisor.mn.gov/laws/2025/0/","fetchedAt":"2026-09-29T00:41:00+00:00","contentType":"text/html; charset=utf-8","sha256":"7c7e4d1195d3e82ec1b26a20687f8b4532f4e06bde6297a6c1a7963f92cedcb1","byteLength":89348,"hostClass":"gov"}],"publisher":{"legislatureNumber":94,"sessionLastYear":2025,"publisherIds":[],"otherCitations":[],"publisherFields":{"Chapter":"Chapter 1","Bill":"SF1552","Presentment Date":"March 14, 2025"},"publisherFieldsOmitted":[]},"provenance":{"textMethod":"html","caveats":["session_label '2025 Regular Session' is the title of the session index page; the chapter page also names its own session ('2025 Regular Session') and bill, both checked against the index, since every special session restarts chapter numbering at 1 and session_ordinal 0 is part of identity.","Amendatory markup kept as the publisher's literal markers. Raw HTML: 16 'new text begin', 16 'new text end', 12 'deleted text begin', 12 'deleted text end', alongside 16 \u003cins> and 12 line-through spans that duplicate them typographically (not also written as wdiff). Extracted text: 16 'new text begin', 16 'new text end', 12 'deleted text begin', 12 'deleted text end'. Counts match."]},"input":"SSL_MN_2025R_G_Y2025_C1","status":"resolved"},{"sessionLawId":"SSL_LA_2025R_G_C2","jurisdiction":"la","citation":"ACT No. 2","citableAs":"La. Acts 2025, No. 2","citationShort":"LA Act 2 (2025)","session":{"code":"2025R","label":"2025 Regular Session","type":"regular","year":2025},"series":"general","instrumentType":"act","number":"2","billNumber":"HOUSE BILL NO. 2","title":"To provide with respect to the capital outlay budget and the capital outlay program for state government, state institutions, and other public entities; to provide for the designation of projects and improvements; to provide for the financing thereof making appropriations from certain sources; and to provide for related matters.","approvedDate":"2025-06-20","approvedDateDerived":false,"effectiveFirst":"2025-06-20","effectiveLast":"2025-06-20","enactmentOutcome":"signed","isLaw":true,"textStatus":"withheld","withheldReason":"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.","charCount":290570,"textSha256":"20b4b897e95427a214dc2c41e37ffabb18513751537d3486d7ffbc22ef639af7","versionNo":1,"amendatoryMarkup":"absent","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:01:58.992647+00:00","citationAsPrinted":"ACT No. 2","vetoStatusAsPrinted":"Signed by the Governor - Act 2","pageCount":162,"effectiveDates":[{"date":"2025-06-20","dateAsPrinted":"06/20/25"}],"otherDates":[{"kind":"approved","date":"2025-06-20","dateAsPrinted":"06/20/25"}],"codeSectionsAffected":[],"sourceUrl":"https://www.legis.la.gov/legis/ViewDocument.aspx?d=1426048","sources":[{"sourceIndex":0,"role":"text","url":"https://www.legis.la.gov/legis/ViewDocument.aspx?d=1426048","fetchedAt":"2026-09-29T00:37:45+00:00","contentType":"application/pdf","sha256":"4fb7220c0f502ff45ee57d7febaa1d86a1d3f94ab239f98d060d3a95c6a053ec","byteLength":560862,"hostClass":"gov"}],"input":"SSL_LA_2025R_G_C2","status":"resolved"}],"resolved":[],"notFound":[{"input":"SSL_MN_1801R_G_Y1801_C9999","status":"not_found","reason":"not_in_registry","detail":"Session law not found. No law in the registry carries this id. Take ids from a /us/session-laws/list result, or send the citation in its place.","didYouMean":[]}],"count":2,"deduped":0,"creditsConsumed":4,"processingTimeMs":584.9}},"citationAndId":{"title":"citationAndId","value":{"laws":[{"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,"coverageStatus":"complete"},"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","citationAsPrinted":"CHAPTER 1--S.F.No. 1552","vetoStatusAsPrinted":"Signed by the governor March 17, 2025, 10:54 a.m.","effectiveDates":[],"otherDates":[{"kind":"approved","date":"2025-03-17","dateAsPrinted":"March 17, 2025, 10:54 a.m."},{"kind":"other","date":"2025-03-14","dateAsPrinted":"March 14, 2025","kindAsPrinted":"Presentment Date"},{"kind":"other","date":"2025-03-14","dateAsPrinted":"March 14, 2025","kindAsPrinted":"Presented to the governor"}],"codeSectionsAffected":[],"sourceUrl":"https://www.revisor.mn.gov/laws/2025/0/Session+Law/Chapter/1/","sources":[{"sourceIndex":0,"role":"text","url":"https://www.revisor.mn.gov/laws/2025/0/Session+Law/Chapter/1/","fetchedAt":"2026-09-29T00:41:01+00:00","contentType":"text/html; charset=utf-8","sha256":"6c83d9c109c1ec61fcd96cea92c8c48414df7ae7dfda7452ebcfbddc181b6b45","byteLength":69907,"hostClass":"gov"},{"sourceIndex":1,"role":"identity","url":"https://www.revisor.mn.gov/laws/2025/0/","fetchedAt":"2026-09-29T00:41:00+00:00","contentType":"text/html; charset=utf-8","sha256":"7c7e4d1195d3e82ec1b26a20687f8b4532f4e06bde6297a6c1a7963f92cedcb1","byteLength":89348,"hostClass":"gov"}],"publisher":{"legislatureNumber":94,"sessionLastYear":2025,"publisherIds":[],"otherCitations":[],"publisherFields":{"Chapter":"Chapter 1","Bill":"SF1552","Presentment Date":"March 14, 2025"},"publisherFieldsOmitted":[]},"provenance":{"textMethod":"html","caveats":["session_label '2025 Regular Session' is the title of the session index page; the chapter page also names its own session ('2025 Regular Session') and bill, both checked against the index, since every special session restarts chapter numbering at 1 and session_ordinal 0 is part of identity.","Amendatory markup kept as the publisher's literal markers. Raw HTML: 16 'new text begin', 16 'new text end', 12 'deleted text begin', 12 'deleted text end', alongside 16 \u003cins> and 12 line-through spans that duplicate them typographically (not also written as wdiff). Extracted text: 16 'new text begin', 16 'new text end', 12 'deleted text begin', 12 'deleted text end'. Counts match."]},"input":"S.F.No. 1552","status":"resolved"}],"resolved":[{"input":"S.F.No. 1552","sessionLawId":"SSL_MN_2025R_G_Y2025_C1","via":"citation","matchedForm":"bill"}],"notFound":[],"count":1,"deduped":0,"creditsConsumed":4,"processingTimeMs":497.1}},"includeBody":{"title":"includeBody","value":{"laws":[{"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,"coverageStatus":"complete"},"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","citationAsPrinted":"CHAPTER 1--S.F.No. 1552","vetoStatusAsPrinted":"Signed by the governor March 17, 2025, 10:54 a.m.","effectiveDates":[],"otherDates":[{"kind":"approved","date":"2025-03-17","dateAsPrinted":"March 17, 2025, 10:54 a.m."},{"kind":"other","date":"2025-03-14","dateAsPrinted":"March 14, 2025","kindAsPrinted":"Presentment Date"},{"kind":"other","date":"2025-03-14","dateAsPrinted":"March 14, 2025","kindAsPrinted":"Presented to the governor"}],"codeSectionsAffected":[],"sourceUrl":"https://www.revisor.mn.gov/laws/2025/0/Session+Law/Chapter/1/","sources":[{"sourceIndex":0,"role":"text","url":"https://www.revisor.mn.gov/laws/2025/0/Session+Law/Chapter/1/","fetchedAt":"2026-09-29T00:41:01+00:00","contentType":"text/html; charset=utf-8","sha256":"6c83d9c109c1ec61fcd96cea92c8c48414df7ae7dfda7452ebcfbddc181b6b45","byteLength":69907,"hostClass":"gov"},{"sourceIndex":1,"role":"identity","url":"https://www.revisor.mn.gov/laws/2025/0/","fetchedAt":"2026-09-29T00:41:00+00:00","contentType":"text/html; charset=utf-8","sha256":"7c7e4d1195d3e82ec1b26a20687f8b4532f4e06bde6297a6c1a7963f92cedcb1","byteLength":89348,"hostClass":"gov"}],"publisher":{"legislatureNumber":94,"sessionLastYear":2025,"publisherIds":[],"otherCitations":[],"publisherFields":{"Chapter":"Chapter 1","Bill":"SF1552","Presentment Date":"March 14, 2025"},"publisherFieldsOmitted":[]},"provenance":{"textMethod":"html","caveats":["session_label '2025 Regular Session' is the title of the session index page; the chapter page also names its own session ('2025 Regular Session') and bill, both checked against the index, since every special session restarts chapter numbering at 1 and session_ordinal 0 is part of identity.","Amendatory markup kept as the publisher's literal markers. Raw HTML: 16 'new text begin', 16 'new text end', 12 'deleted text begin', 12 'deleted text end', alongside 16 \u003cins> and 12 line-through spans that duplicate them typographically (not also written as wdiff). Extracted text: 16 'new text begin', 16 'new text end', 12 'deleted text begin', 12 'deleted text end'. Counts match."]},"input":"SSL_MN_2025R_G_Y2025_C1","status":"resolved","body":"CHAPTER 1--S.F.No. 1552\n\nAn act\n\nrelating to agriculture; modifying financial reporting requirements for grain buyers; amending Minnesota Statutes 2024, section 223.17, subdivision 6. ...","bodyPageEnd":5470,"bodyTotalChars":5470,"bodyHasMore":false}],"resolved":[],"notFound":[],"count":1,"deduped":0,"creditsConsumed":8,"processingTimeMs":731.2}}},"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"},"d99e99cf-3d79-49b3-9ac1-5f61acfdbf91":{"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"},"d97430e5-317a-4c78-a219-b94236738417":{"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"},"615f45c5-4ed3-4366-b71c-a4e298b07633":{"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"},"542377e5-eedf-4d2b-adf7-4341abef5db5":{"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"},"20febb2e-bc05-44a4-9ce3-4d8f4c72e5b2":{"description":"A parameter failed validation: `ids` empty, over-long or holding more than 50 distinct entries, `jurisdiction` not a state, or a key the body does not define. 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":{"emptyIds":{"title":"emptyIds","value":{"detail":"Invalid request parameters","errors":[{"loc":["body","ids"],"msg":"List should have at least 1 item after validation, not 0","type":"too_short"}]}},"tooManyIds":{"title":"tooManyIds","value":{"detail":"Invalid request parameters","errors":[{"loc":["body","ids"],"msg":"Value error, `ids` holds 51 distinct entries after duplicates collapse; the limit is 50 per call. Split the batch.","type":"value_error"}]}},"federalJurisdiction":{"title":"federalJurisdiction","value":{"detail":"Invalid request parameters","errors":[{"loc":["body","jurisdiction"],"msg":"Value error, Unknown `jurisdiction` value 'federal'. Expected one of: ak, al, ar, as, az, ca, co, ct, dc, de, fl, ga, gu, hi, ia, id, il, in, ks, ky, la, ma, md, me, mi, mn, mo, mp, ms, mt, nc, nd, ne, nh, nj, nm, nv, ny, oh, ok, or, pa, pr, ri, sc, sd, tn, tx, ut, va, vi, vt, wa, wi, wv, wy.","type":"value_error"}]}},"unknownField":{"title":"unknownField","value":{"detail":"Invalid request parameters","errors":[{"loc":["body","includebody"],"msg":"Extra inputs are not permitted","type":"extra_forbidden"}]}}},"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"},"d58ffde3-43f5-4ee8-a107-fa9371f1917c":{"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"},"0866f505-a990-4a5e-80d5-a83fc6bf3ee8":{"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"},"964b6b12-23cd-4462-9aff-841df61b330c":{"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":"Get many state session laws at once, by id or citation - Vaquill AI","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"originalFileLocation":"api-reference/us-session-laws/get-many-state-session-laws-at-once-by-id-or-citation.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=\"Read up to 50 STATE session laws in one call: the same record GET /us/session-laws/{sessionLawId} returns, for each id or citation in ids, in the order you sent them. Use it when you are enriching a list (a sync job holding ids from /us/session-laws/list or /us/session-laws/changes, or an agent handed a memo with a dozen session-law citations) instead of making a round trip per law. When to use this instead of POST /us/statutes/resolve. resolve identifies a citation: it costs 2 credits per item and answers with a sessionLaw match block (title, dates, source link), never the record or its text. This route returns the FULL record of each law, the same as GET /us/session-laws/{sessionLawId} (2 credits per law served), and optionally the first page of its text. Use resolve to find the id; use this route to read many laws in one request instead of one call each, which matters under the default limit of 30 requests per minute per key (a plan raises it). Cost: 2 credits per law served, the single-lookup price. Batching buys a round trip, not a discount. A miss is not charged, and creditsConsumed reports what was actually billed. A citation in ids also pays the /us/statutes/resolve price (2 credits), as its own ledger line, exactly as GET /us/session-laws/{sessionLawId} charges a citation: kept whenever we gave a verdict (a served law, an unresolved or ambiguous citation) and refunded when the session it points into is only partly collected, or when we failed. An id never pays it. Every entry gets an answer. A served law is in laws; every other entry is in notFound with a status (not_found, unparsed, ambiguous, needs_jurisdiction, session_not_fully_collected, federal, or error), the finer reason the single route\u0026#x27;s 404 carries, the same detail sentence, and the candidates where there are any. Nothing is dropped silently, so a shorter laws array can always be explained: every distinct entry is in laws, in notFound, or, when it names a law an earlier entry already produced, in resolved. Mapping your inputs. laws holds only the laws served, so it cannot be zipped back onto ids by position. Each law carries the input it answers, and resolved lists every input that did not match an id exactly as sent (a citation, or an id cleaned of whitespace, quotes or a trailing period) with the id it resolved to. Duplicates are collapsed first: an entry identical to an earlier one after trimming is dropped, order is kept, and deduped says how many. Two DIFFERENT spellings of one law (S.F.No. 1552 and its sessionLawId) serve the law once, under the first, bill it once, and list both in resolved. Statuses. resolved: served. not_held: served as a record, because the registry knows the law and holds no text (textStatus: not_held). not_found: no law carries the id. unparsed: it reads as a citation no state session law we hold carries. ambiguous: the citation names several laws, all in didYouMean, none chosen for you (Minnesota 2025 has two Chapter 1s). needs_jurisdiction: a form several states share, naming none: send jurisdiction or name the state. session_not_fully_collected: nothing matched in a session we have only partly collected, so the law may exist; never charged, the resolve price included. federal: federal acts are served by /us/statutes/section. error: WE failed to look this entry up. It says nothing about the law, is refunded in full, and is safe to resend. jurisdiction scopes how every citation in the batch is read, exactly as the same parameter does on the single route. It is validated before anything is charged: a bad code is a 422. includeBody adds the FIRST page of each served law\u0026#x27;s text (about 30,000 characters) as body, at the body price (6 credits) per law whose page is served, charged after the work because the count is not knowable up front. It multiplies with the batch: 50 laws at 2 + 6 is 400 credits in one call. A law whose text is withheld, not held or empty returns body: null and is not charged for it. If your balance cannot cover the pages after the records were served, the records are returned without bodies rather than taking the paid-for result away. bodyNextCursor continues a longer act on GET /us/session-laws/{sessionLawId}/body. Limits. At most 50 DISTINCT entries after duplicates collapse (a raw list of up to 200 is accepted so a run of repeats is not refused), each at most 300 characters. An empty list, an over-long entry, more than 50 distinct entries or a bad jurisdiction is a 422 and nothing is charged. At most 8 lookups run at once inside a call. Example bash curl -X POST \u0026quot;https://api.vaquill.ai/api/v1/us/session-laws/batch\u0026quot; \\ -H \u0026quot;Authorization: Bearer $VAQUILL_API_KEY\u0026quot; -H \u0026quot;Content-Type: application/json\u0026quot; \\ -d \u0026#x27;{\u0026quot;ids\u0026quot;: [\u0026quot;SSL_MN_2025R_G_Y2025_C1\u0026quot;, \u0026quot;S.F.No. 1552\u0026quot;], \u0026quot;jurisdiction\u0026quot;: \u0026quot;mn\u0026quot;}\u0026#x27; ``javascript const res = await fetch(\u0026quot;https://api.vaquill.ai/api/v1/us/session-laws/batch\u0026quot;, { method: \u0026quot;POST\u0026quot;, headers: { Authorization: Bearer ${process.env.VAQUILL_API_KEY}, \u0026quot;Content-Type\u0026quot;: \u0026quot;application/json\u0026quot;, }, body: JSON.stringify({ ids: [\u0026quot;SSL_MN_2025R_G_Y2025_C1\u0026quot;, \u0026quot;S.F.No. 1552\u0026quot;], jurisdiction: \u0026quot;mn\u0026quot; }), }); const { laws, notFound, resolved } = await res.json(); const byInput = new Map(laws.map((law) =\u0026gt; [law.input, law])); ` Related endpoints - GET /us/session-laws/{sessionLawId} is the single read, with the same record and rules. - GET /us/session-laws/list and GET /us/session-laws/changes are where the ids come from. - GET /us/statutes/resolve points a session-law citation here. 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. 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=\"Get many state session laws at once, by id or citation - Vaquill AI\">\u003cmeta data-mint-head property=\"og:description\" content=\"Read up to 50 STATE session laws in one call: the same record GET /us/session-laws/{sessionLawId} returns, for each id or citation in ids, in the order you sent them. Use it when you are enriching a list (a sync job holding ids from /us/session-laws/list or /us/session-laws/changes, or an agent handed a memo with a dozen session-law citations) instead of making a round trip per law. When to use this instead of POST /us/statutes/resolve. resolve identifies a citation: it costs 2 credits per item and answers with a sessionLaw match block (title, dates, source link), never the record or its text. This route returns the FULL record of each law, the same as GET /us/session-laws/{sessionLawId} (2 credits per law served), and optionally the first page of its text. Use resolve to find the id; use this route to read many laws in one request instead of one call each, which matters under the default limit of 30 requests per minute per key (a plan raises it). Cost: 2 credits per law served, the single-lookup price. Batching buys a round trip, not a discount. A miss is not charged, and creditsConsumed reports what was actually billed. A citation in ids also pays the /us/statutes/resolve price (2 credits), as its own ledger line, exactly as GET /us/session-laws/{sessionLawId} charges a citation: kept whenever we gave a verdict (a served law, an unresolved or ambiguous citation) and refunded when the session it points into is only partly collected, or when we failed. An id never pays it. Every entry gets an answer. A served law is in laws; every other entry is in notFound with a status (not_found, unparsed, ambiguous, needs_jurisdiction, session_not_fully_collected, federal, or error), the finer reason the single route\u0026#x27;s 404 carries, the same detail sentence, and the candidates where there are any. Nothing is dropped silently, so a shorter laws array can always be explained: every distinct entry is in laws, in notFound, or, when it names a law an earlier entry already produced, in resolved. Mapping your inputs. laws holds only the laws served, so it cannot be zipped back onto ids by position. Each law carries the input it answers, and resolved lists every input that did not match an id exactly as sent (a citation, or an id cleaned of whitespace, quotes or a trailing period) with the id it resolved to. Duplicates are collapsed first: an entry identical to an earlier one after trimming is dropped, order is kept, and deduped says how many. Two DIFFERENT spellings of one law (S.F.No. 1552 and its sessionLawId) serve the law once, under the first, bill it once, and list both in resolved. Statuses. resolved: served. not_held: served as a record, because the registry knows the law and holds no text (textStatus: not_held). not_found: no law carries the id. unparsed: it reads as a citation no state session law we hold carries. ambiguous: the citation names several laws, all in didYouMean, none chosen for you (Minnesota 2025 has two Chapter 1s). needs_jurisdiction: a form several states share, naming none: send jurisdiction or name the state. session_not_fully_collected: nothing matched in a session we have only partly collected, so the law may exist; never charged, the resolve price included. federal: federal acts are served by /us/statutes/section. error: WE failed to look this entry up. It says nothing about the law, is refunded in full, and is safe to resend. jurisdiction scopes how every citation in the batch is read, exactly as the same parameter does on the single route. It is validated before anything is charged: a bad code is a 422. includeBody adds the FIRST page of each served law\u0026#x27;s text (about 30,000 characters) as body, at the body price (6 credits) per law whose page is served, charged after the work because the count is not knowable up front. It multiplies with the batch: 50 laws at 2 + 6 is 400 credits in one call. A law whose text is withheld, not held or empty returns body: null and is not charged for it. If your balance cannot cover the pages after the records were served, the records are returned without bodies rather than taking the paid-for result away. bodyNextCursor continues a longer act on GET /us/session-laws/{sessionLawId}/body. Limits. At most 50 DISTINCT entries after duplicates collapse (a raw list of up to 200 is accepted so a run of repeats is not refused), each at most 300 characters. An empty list, an over-long entry, more than 50 distinct entries or a bad jurisdiction is a 422 and nothing is charged. At most 8 lookups run at once inside a call. Example bash curl -X POST \u0026quot;https://api.vaquill.ai/api/v1/us/session-laws/batch\u0026quot; \\ -H \u0026quot;Authorization: Bearer $VAQUILL_API_KEY\u0026quot; -H \u0026quot;Content-Type: application/json\u0026quot; \\ -d \u0026#x27;{\u0026quot;ids\u0026quot;: [\u0026quot;SSL_MN_2025R_G_Y2025_C1\u0026quot;, \u0026quot;S.F.No. 1552\u0026quot;], \u0026quot;jurisdiction\u0026quot;: \u0026quot;mn\u0026quot;}\u0026#x27; ``javascript const res = await fetch(\u0026quot;https://api.vaquill.ai/api/v1/us/session-laws/batch\u0026quot;, { method: \u0026quot;POST\u0026quot;, headers: { Authorization: Bearer ${process.env.VAQUILL_API_KEY}, \u0026quot;Content-Type\u0026quot;: \u0026quot;application/json\u0026quot;, }, body: JSON.stringify({ ids: [\u0026quot;SSL_MN_2025R_G_Y2025_C1\u0026quot;, \u0026quot;S.F.No. 1552\u0026quot;], jurisdiction: \u0026quot;mn\u0026quot; }), }); const { laws, notFound, resolved } = await res.json(); const byInput = new Map(laws.map((law) =\u0026gt; [law.input, law])); ` Related endpoints - GET /us/session-laws/{sessionLawId} is the single read, with the same record and rules. - GET /us/session-laws/list and GET /us/session-laws/changes are where the ids come from. - GET /us/statutes/resolve points a session-law citation here. 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. 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/get-many-state-session-laws-at-once-by-id-or-citation\">\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=Get+many+state+session+laws+at+once%2C+by+id+or+citation\u0026amp;description=Read+up+to+50+STATE+session+laws+in+one+call%3A+the+same+record%0A%60GET+%2Fus%2Fsession-laws%2F%7BsessionLawId%7D%60+returns%2C+for+each+id+or+citation+in+%60ids%60%2C+in+the+order%0Ayou+\u0026amp;theme=c0fd5b007b30a7a110519c4a\u0026amp;signature=a95bc99709d8a5a3a829785daf946807dc472eff88a66f1e2c1953b680356ea6\">\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=\"Get many state session laws at once, by id or citation - Vaquill AI\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Read up to 50 STATE session laws in one call: the same record GET /us/session-laws/{sessionLawId} returns, for each id or citation in ids, in the order you sent them. Use it when you are enriching a list (a sync job holding ids from /us/session-laws/list or /us/session-laws/changes, or an agent handed a memo with a dozen session-law citations) instead of making a round trip per law. When to use this instead of POST /us/statutes/resolve. resolve identifies a citation: it costs 2 credits per item and answers with a sessionLaw match block (title, dates, source link), never the record or its text. This route returns the FULL record of each law, the same as GET /us/session-laws/{sessionLawId} (2 credits per law served), and optionally the first page of its text. Use resolve to find the id; use this route to read many laws in one request instead of one call each, which matters under the default limit of 30 requests per minute per key (a plan raises it). Cost: 2 credits per law served, the single-lookup price. Batching buys a round trip, not a discount. A miss is not charged, and creditsConsumed reports what was actually billed. A citation in ids also pays the /us/statutes/resolve price (2 credits), as its own ledger line, exactly as GET /us/session-laws/{sessionLawId} charges a citation: kept whenever we gave a verdict (a served law, an unresolved or ambiguous citation) and refunded when the session it points into is only partly collected, or when we failed. An id never pays it. Every entry gets an answer. A served law is in laws; every other entry is in notFound with a status (not_found, unparsed, ambiguous, needs_jurisdiction, session_not_fully_collected, federal, or error), the finer reason the single route\u0026#x27;s 404 carries, the same detail sentence, and the candidates where there are any. Nothing is dropped silently, so a shorter laws array can always be explained: every distinct entry is in laws, in notFound, or, when it names a law an earlier entry already produced, in resolved. Mapping your inputs. laws holds only the laws served, so it cannot be zipped back onto ids by position. Each law carries the input it answers, and resolved lists every input that did not match an id exactly as sent (a citation, or an id cleaned of whitespace, quotes or a trailing period) with the id it resolved to. Duplicates are collapsed first: an entry identical to an earlier one after trimming is dropped, order is kept, and deduped says how many. Two DIFFERENT spellings of one law (S.F.No. 1552 and its sessionLawId) serve the law once, under the first, bill it once, and list both in resolved. Statuses. resolved: served. not_held: served as a record, because the registry knows the law and holds no text (textStatus: not_held). not_found: no law carries the id. unparsed: it reads as a citation no state session law we hold carries. ambiguous: the citation names several laws, all in didYouMean, none chosen for you (Minnesota 2025 has two Chapter 1s). needs_jurisdiction: a form several states share, naming none: send jurisdiction or name the state. session_not_fully_collected: nothing matched in a session we have only partly collected, so the law may exist; never charged, the resolve price included. federal: federal acts are served by /us/statutes/section. error: WE failed to look this entry up. It says nothing about the law, is refunded in full, and is safe to resend. jurisdiction scopes how every citation in the batch is read, exactly as the same parameter does on the single route. It is validated before anything is charged: a bad code is a 422. includeBody adds the FIRST page of each served law\u0026#x27;s text (about 30,000 characters) as body, at the body price (6 credits) per law whose page is served, charged after the work because the count is not knowable up front. It multiplies with the batch: 50 laws at 2 + 6 is 400 credits in one call. A law whose text is withheld, not held or empty returns body: null and is not charged for it. If your balance cannot cover the pages after the records were served, the records are returned without bodies rather than taking the paid-for result away. bodyNextCursor continues a longer act on GET /us/session-laws/{sessionLawId}/body. Limits. At most 50 DISTINCT entries after duplicates collapse (a raw list of up to 200 is accepted so a run of repeats is not refused), each at most 300 characters. An empty list, an over-long entry, more than 50 distinct entries or a bad jurisdiction is a 422 and nothing is charged. At most 8 lookups run at once inside a call. Example bash curl -X POST \u0026quot;https://api.vaquill.ai/api/v1/us/session-laws/batch\u0026quot; \\ -H \u0026quot;Authorization: Bearer $VAQUILL_API_KEY\u0026quot; -H \u0026quot;Content-Type: application/json\u0026quot; \\ -d \u0026#x27;{\u0026quot;ids\u0026quot;: [\u0026quot;SSL_MN_2025R_G_Y2025_C1\u0026quot;, \u0026quot;S.F.No. 1552\u0026quot;], \u0026quot;jurisdiction\u0026quot;: \u0026quot;mn\u0026quot;}\u0026#x27; ``javascript const res = await fetch(\u0026quot;https://api.vaquill.ai/api/v1/us/session-laws/batch\u0026quot;, { method: \u0026quot;POST\u0026quot;, headers: { Authorization: Bearer ${process.env.VAQUILL_API_KEY}, \u0026quot;Content-Type\u0026quot;: \u0026quot;application/json\u0026quot;, }, body: JSON.stringify({ ids: [\u0026quot;SSL_MN_2025R_G_Y2025_C1\u0026quot;, \u0026quot;S.F.No. 1552\u0026quot;], jurisdiction: \u0026quot;mn\u0026quot; }), }); const { laws, notFound, resolved } = await res.json(); const byInput = new Map(laws.map((law) =\u0026gt; [law.input, law])); ` Related endpoints - GET /us/session-laws/{sessionLawId} is the single read, with the same record and rules. - GET /us/session-laws/list and GET /us/session-laws/changes are where the ids come from. - GET /us/statutes/resolve points a session-law citation here. 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. 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=Get+many+state+session+laws+at+once%2C+by+id+or+citation\u0026amp;description=Read+up+to+50+STATE+session+laws+in+one+call%3A+the+same+record%0A%60GET+%2Fus%2Fsession-laws%2F%7BsessionLawId%7D%60+returns%2C+for+each+id+or+citation+in+%60ids%60%2C+in+the+order%0Ayou+\u0026amp;theme=c0fd5b007b30a7a110519c4a\u0026amp;signature=a95bc99709d8a5a3a829785daf946807dc472eff88a66f1e2c1953b680356ea6\">\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/get-many-state-session-laws-at-once-by-id-or-citation\">\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/get-many-state-session-laws-at-once-by-id-or-citation.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/get-many-state-session-laws-at-once-by-id-or-citation#webpage\",\"url\":\"https://www.vaquill.ai/docs/api-reference/us-session-laws/get-many-state-session-laws-at-once-by-id-or-citation\",\"name\":\"Get many state session laws at once, by id or citation\",\"description\":\"Read up to 50 STATE session laws in one call: the same record GET /us/session-laws/{sessionLawId} returns, for each id or citation in ids, in the order you sent them. Use it when you are enriching a list (a sync job holding ids from /us/session-laws/list or /us/session-laws/changes, or an agent handed a memo with a dozen session-law citations) instead of making a round trip per law. When to use this instead of POST /us/statutes/resolve. resolve identifies a citation: it costs 2 credits per item and answers with a sessionLaw match block (title, dates, source link), never the record or its text. This route returns the FULL record of each law, the same as GET /us/session-laws/{sessionLawId} (2 credits per law served), and optionally the first page of its text. Use resolve to find the id; use this route to read many laws in one request instead of one call each, which matters under the default limit of 30 requests per minute per key (a plan raises it). Cost: 2 credits per law served, the single-lookup price. Batching buys a round trip, not a discount. A miss is not charged, and creditsConsumed reports what was actually billed. A citation in ids also pays the /us/statutes/resolve price (2 credits), as its own ledger line, exactly as GET /us/session-laws/{sessionLawId} charges a citation: kept whenever we gave a verdict (a served law, an unresolved or ambiguous citation) and refunded when the session it points into is only partly collected, or when we failed. An id never pays it. Every entry gets an answer. A served law is in laws; every other entry is in notFound with a status (not_found, unparsed, ambiguous, needs_jurisdiction, session_not_fully_collected, federal, or error), the finer reason the single route's 404 carries, the same detail sentence, and the candidates where there are any. Nothing is dropped silently, so a shorter laws array can always be explained: every distinct entry is in laws, in notFound, or, when it names a law an earlier entry already produced, in resolved. Mapping your inputs. laws holds only the laws served, so it cannot be zipped back onto ids by position. Each law carries the input it answers, and resolved lists every input that did not match an id exactly as sent (a citation, or an id cleaned of whitespace, quotes or a trailing period) with the id it resolved to. Duplicates are collapsed first: an entry identical to an earlier one after trimming is dropped, order is kept, and deduped says how many. Two DIFFERENT spellings of one law (S.F.No. 1552 and its sessionLawId) serve the law once, under the first, bill it once, and list both in resolved. Statuses. resolved: served. not_held: served as a record, because the registry knows the law and holds no text (textStatus: not_held). not_found: no law carries the id. unparsed: it reads as a citation no state session law we hold carries. ambiguous: the citation names several laws, all in didYouMean, none chosen for you (Minnesota 2025 has two Chapter 1s). needs_jurisdiction: a form several states share, naming none: send jurisdiction or name the state. session_not_fully_collected: nothing matched in a session we have only partly collected, so the law may exist; never charged, the resolve price included. federal: federal acts are served by /us/statutes/section. error: WE failed to look this entry up. It says nothing about the law, is refunded in full, and is safe to resend. jurisdiction scopes how every citation in the batch is read, exactly as the same parameter does on the single route. It is validated before anything is charged: a bad code is a 422. includeBody adds the FIRST page of each served law's text (about 30,000 characters) as body, at the body price (6 credits) per law whose page is served, charged after the work because the count is not knowable up front. It multiplies with the batch: 50 laws at 2 + 6 is 400 credits in one call. A law whose text is withheld, not held or empty returns body: null and is not charged for it. If your balance cannot cover the pages after the records were served, the records are returned without bodies rather than taking the paid-for result away. bodyNextCursor continues a longer act on GET /us/session-laws/{sessionLawId}/body. Limits. At most 50 DISTINCT entries after duplicates collapse (a raw list of up to 200 is accepted so a run of repeats is not refused), each at most 300 characters. An empty list, an over-long entry, more than 50 distinct entries or a bad jurisdiction is a 422 and nothing is charged. At most 8 lookups run at once inside a call. Example bash curl -X POST \\\"https://api.vaquill.ai/api/v1/us/session-laws/batch\\\" \\\\ -H \\\"Authorization: Bearer $VAQUILL_API_KEY\\\" -H \\\"Content-Type: application/json\\\" \\\\ -d '{\\\"ids\\\": [\\\"SSL_MN_2025R_G_Y2025_C1\\\", \\\"S.F.No. 1552\\\"], \\\"jurisdiction\\\": \\\"mn\\\"}' ``javascript const res = await fetch(\\\"https://api.vaquill.ai/api/v1/us/session-laws/batch\\\", { method: \\\"POST\\\", headers: { Authorization: Bearer ${process.env.VAQUILL_API_KEY}, \\\"Content-Type\\\": \\\"application/json\\\", }, body: JSON.stringify({ ids: [\\\"SSL_MN_2025R_G_Y2025_C1\\\", \\\"S.F.No. 1552\\\"], jurisdiction: \\\"mn\\\" }), }); const { laws, notFound, resolved } = await res.json(); const byInput = new Map(laws.map((law) => [law.input, law])); ` Related endpoints - GET /us/session-laws/{sessionLawId} is the single read, with the same record and rules. - GET /us/session-laws/list and GET /us/session-laws/changes are where the ids come from. - GET /us/statutes/resolve points a session-law citation here. 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. 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/get-many-state-session-laws-at-once-by-id-or-citation#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.vaquill.ai/docs/api-reference/us-session-laws/get-many-state-session-laws-at-once-by-id-or-citation#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\":\"Get many state session laws at once, by id or citation\",\"item\":\"https://www.vaquill.ai/docs/api-reference/us-session-laws/get-many-state-session-laws-at-once-by-id-or-citation\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://www.vaquill.ai/docs/api-reference/us-session-laws/get-many-state-session-laws-at-once-by-id-or-citation#apireference\",\"headline\":\"Get many state session laws at once, by id or citation\",\"name\":\"Get many state session laws at once, by id or citation\",\"description\":\"Read up to 50 STATE session laws in one call: the same record GET /us/session-laws/{sessionLawId} returns, for each id or citation in ids, in the order you sent them. Use it when you are enriching a list (a sync job holding ids from /us/session-laws/list or /us/session-laws/changes, or an agent handed a memo with a dozen session-law citations) instead of making a round trip per law. When to use this instead of POST /us/statutes/resolve. resolve identifies a citation: it costs 2 credits per item and answers with a sessionLaw match block (title, dates, source link), never the record or its text. This route returns the FULL record of each law, the same as GET /us/session-laws/{sessionLawId} (2 credits per law served), and optionally the first page of its text. Use resolve to find the id; use this route to read many laws in one request instead of one call each, which matters under the default limit of 30 requests per minute per key (a plan raises it). Cost: 2 credits per law served, the single-lookup price. Batching buys a round trip, not a discount. A miss is not charged, and creditsConsumed reports what was actually billed. A citation in ids also pays the /us/statutes/resolve price (2 credits), as its own ledger line, exactly as GET /us/session-laws/{sessionLawId} charges a citation: kept whenever we gave a verdict (a served law, an unresolved or ambiguous citation) and refunded when the session it points into is only partly collected, or when we failed. An id never pays it. Every entry gets an answer. A served law is in laws; every other entry is in notFound with a status (not_found, unparsed, ambiguous, needs_jurisdiction, session_not_fully_collected, federal, or error), the finer reason the single route's 404 carries, the same detail sentence, and the candidates where there are any. Nothing is dropped silently, so a shorter laws array can always be explained: every distinct entry is in laws, in notFound, or, when it names a law an earlier entry already produced, in resolved. Mapping your inputs. laws holds only the laws served, so it cannot be zipped back onto ids by position. Each law carries the input it answers, and resolved lists every input that did not match an id exactly as sent (a citation, or an id cleaned of whitespace, quotes or a trailing period) with the id it resolved to. Duplicates are collapsed first: an entry identical to an earlier one after trimming is dropped, order is kept, and deduped says how many. Two DIFFERENT spellings of one law (S.F.No. 1552 and its sessionLawId) serve the law once, under the first, bill it once, and list both in resolved. Statuses. resolved: served. not_held: served as a record, because the registry knows the law and holds no text (textStatus: not_held). not_found: no law carries the id. unparsed: it reads as a citation no state session law we hold carries. ambiguous: the citation names several laws, all in didYouMean, none chosen for you (Minnesota 2025 has two Chapter 1s). needs_jurisdiction: a form several states share, naming none: send jurisdiction or name the state. session_not_fully_collected: nothing matched in a session we have only partly collected, so the law may exist; never charged, the resolve price included. federal: federal acts are served by /us/statutes/section. error: WE failed to look this entry up. It says nothing about the law, is refunded in full, and is safe to resend. jurisdiction scopes how every citation in the batch is read, exactly as the same parameter does on the single route. It is validated before anything is charged: a bad code is a 422. includeBody adds the FIRST page of each served law's text (about 30,000 characters) as body, at the body price (6 credits) per law whose page is served, charged after the work because the count is not knowable up front. It multiplies with the batch: 50 laws at 2 + 6 is 400 credits in one call. A law whose text is withheld, not held or empty returns body: null and is not charged for it. If your balance cannot cover the pages after the records were served, the records are returned without bodies rather than taking the paid-for result away. bodyNextCursor continues a longer act on GET /us/session-laws/{sessionLawId}/body. Limits. At most 50 DISTINCT entries after duplicates collapse (a raw list of up to 200 is accepted so a run of repeats is not refused), each at most 300 characters. An empty list, an over-long entry, more than 50 distinct entries or a bad jurisdiction is a 422 and nothing is charged. At most 8 lookups run at once inside a call. Example bash curl -X POST \\\"https://api.vaquill.ai/api/v1/us/session-laws/batch\\\" \\\\ -H \\\"Authorization: Bearer $VAQUILL_API_KEY\\\" -H \\\"Content-Type: application/json\\\" \\\\ -d '{\\\"ids\\\": [\\\"SSL_MN_2025R_G_Y2025_C1\\\", \\\"S.F.No. 1552\\\"], \\\"jurisdiction\\\": \\\"mn\\\"}' ``javascript const res = await fetch(\\\"https://api.vaquill.ai/api/v1/us/session-laws/batch\\\", { method: \\\"POST\\\", headers: { Authorization: Bearer ${process.env.VAQUILL_API_KEY}, \\\"Content-Type\\\": \\\"application/json\\\", }, body: JSON.stringify({ ids: [\\\"SSL_MN_2025R_G_Y2025_C1\\\", \\\"S.F.No. 1552\\\"], jurisdiction: \\\"mn\\\" }), }); const { laws, notFound, resolved } = await res.json(); const byInput = new Map(laws.map((law) => [law.input, law])); ` Related endpoints - GET /us/session-laws/{sessionLawId} is the single read, with the same record and rules. - GET /us/session-laws/list and GET /us/session-laws/changes are where the ids come from. - GET /us/statutes/resolve points a session-law citation here. 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. 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/get-many-state-session-laws-at-once-by-id-or-citation\",\"mainEntityOfPage\":{\"@id\":\"https://www.vaquill.ai/docs/api-reference/us-session-laws/get-many-state-session-laws-at-once-by-id-or-citation#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","description":"A sync feed of the registry: every state law that began to be served, had its text added, was\ncorrected, unserved, withdrawn or merged, oldest first, as a cursor over an integer `id`. Poll it\nto keep a copy of the registry current without re-listing it: read from `sinceId=0` once, then\ncall again with the `cursor` you were given.\n\n**Cost**: 1 credit per page of up to 200 entries (default 50). An empty\npage is an answer, \"nothing changed since your cursor\", and is charged. A request that fails\nvalidation (422) is never charged; a failure on our side (500, 503) is refunded.\n\n**Walking the feed.** Send `sinceId=0` for the first page. While `hasMore` is true, call again with\n`sinceId` set to `cursor`: the feed is ordered by `id`, `id` only grows, and a page carries the\nentries after `sinceId` and nothing else, so no entry is skipped or repeated between your calls.\nWhen `hasMore` is false you have caught up as of this call; keep your cursor and ask again later.\nAn empty page has `cursor: null`: keep the one you hold.\n\n**What an entry says.** `kind` is what happened (see its description), `sessionLawId` the law,\n`jurisdiction` its state, and `detectedAt` when we recorded it, an upper bound on when the law\nchanged in the world and never an approval or effective date. Read the law itself at\n`GET /us/session-laws/{sessionLawId}`, or many at once with `POST /us/session-laws/batch`. A\n`withdrawn` or `merged` entry is a tombstone: the law no longer answers there.\n\n**Filter.** `jurisdiction` limits the feed to one state, `dc` or `pr`, and then `hasMore` means\nmore MATCHING entries follow. The cursor is a position in the whole feed, so the same `sinceId`\nmeans the same point with or without the filter, and a filtered page can skip ids.\n\n**Read a short window behind your cursor.** `id` is assigned in order but a row can become visible\nslightly after a later one if two writers commit at once. Every writer today commits a whole\nbatch together, so this has not happened, but a job that must never miss an entry should re-read\nthe last few hundred ids it has already seen.\n\n**Scope.** State session laws only: federal acts (`SAL_...`) are never in this feed.\n\n**Example**\n\n```bash\ncurl \"https://api.vaquill.ai/api/v1/us/session-laws/changes?sinceId=0\u0026limit=100\" \\\n -H \"Authorization: Bearer $VAQUILL_API_KEY\"\n```\n\n```javascript\nlet cursor = 0;\nfor (;;) {\n const res = await fetch(`https://api.vaquill.ai/api/v1/us/session-laws/changes?sinceId=${cursor}`, {\n headers: { Authorization: `Bearer ${process.env.VAQUILL_API_KEY}` },\n });\n const page = await res.json();\n for (const change of page.changes) handle(change);\n if (page.cursor !== null) cursor = page.cursor;\n if (!page.hasMore) break;\n}\n```\n\n**Related endpoints**\n\n- `GET /us/session-laws/list` lists the laws of one state, filtered; this feed is how you learn\n that one changed.\n- `POST /us/session-laws/batch` reads many laws at once from the ids this feed returns.\n- `GET /us/statutes/coverage` says which sessions we hold and how complete each is, in each\n jurisdiction's `sessionLaws` block.\n\n**Nulls.** Every field of a response is always present: one with no value is `null` (or `[]`\nfor a list). The examples on this page leave the nulls out for brevity.","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","description":"Find state session laws by what they SAY. Send a question in plain words, words from a title, a quoted\nphrase, a citation (`63-3004`), a code section or a bill number (`S.F.No. 1552`). You get the laws, best\nfirst, each with the passage of its text that matched and a snippet around your words.\n\n**Cost**: 4 credits per page, each page a new search. An empty result is an answer (\"nothing\nmatches\") and is charged. A request that fails validation (422) is never charged; a failure on our side\n(500, 503) is refunded. To read a law you found, use `GET /us/session-laws/{sessionLawId}` (record) or\nits `/body` (text), which are priced on their own.\n\n**What is searched.** The ENACTED text: the law as it reads once the act takes effect. Language an act\nstrikes out is not searched and never appears in a snippet, so a repealed word cannot match as if it were\nlaw. Only laws we serve with text are searched (see `GET /us/statutes/coverage`, `sessionLaws`, for what\neach state holds). Laws whose text we withhold are not returned, unless you send `includeUnverified`\n(default `false`): then a withheld law whose reason we can label may appear, each such result carrying\n`holdingState: quarantined`, `textReliability` and `reasonCode`, and it is matched by its title, code\nsection, citation or bill number rather than by the words of its text.\n\n**How it ranks.** Keyword relevance (BM25), not meaning. Words are matched as written and stemmed\n(`licensing` finds `licensed`), so a question has to share vocabulary with the act:\n`teeth cleaning professional` does not find an act that says `dental hygienist`. A law matched by its\ntitle AND its text, or by an exact part of your query, ranks above one matched a single way. Quote a\nphrase to require it verbatim.\n\n**What a result says about itself.** `matchType` is `exact` when a quoted phrase, citation, code\nsection or bill number you typed matched, otherwise `text`; `matchedBy` lists every way. Neither says\nthe law is the right one: a question with no true answer still returns its closest words, and there is no\n\"no good match\" flag because keyword scores do not separate the two cases. Read the snippet.\n\n**Paging.** `limit` is 1 to 25. `offset` plus `limit` reaches at most the 60 best matches; narrow with\n`jurisdiction`, `session`, `series`, `instrumentType` or the approval dates rather than paging deeper.\n\n```bash\ncurl -X POST \"https://api.vaquill.ai/api/v1/us/session-laws/search\" \\\n -H \"Authorization: Bearer vq_key_...\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"query\": \"can the sheriff pay with a debit card\", \"jurisdiction\": \"al\", \"limit\": 5}'\n```\n\n```javascript\nconst res = await fetch(\"https://api.vaquill.ai/api/v1/us/session-laws/search\", {\n method: \"POST\",\n headers: { Authorization: \"Bearer vq_key_...\", \"Content-Type\": \"application/json\" },\n body: JSON.stringify({ query: '\"credit card or debit card\"', jurisdiction: \"al\", limit: 5 }),\n});\nconst { results } = await res.json();\n```\n\n**Related.** `GET /us/session-laws/list` filters one state's laws by session, series and date;\n`POST /us/session-laws/batch` reads up to 50 laws by id; `GET /us/statutes/section/{actId}/enactments`\nlists the acts a publisher's own tables tie to a code section.","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","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","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":"Get many state session laws at once, by id or citation - 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"]}