List every served version of a state session law

Every version of one state session law that we served or adopted, newest first, and which of them is current. A law’s text can be corrected after we first serve it (a better extraction of the same source, a re-collection), so the version you read yesterday may not be the one a plain call returns today. This route lists each version with what identifies it (when we recorded it, its length, its hash, how the text was taken) and how its text can be read. It carries no text: read one version with GET /us/session-laws/{sessionLawId}/body?version=N.

Cost: 1 credit per call, however many versions the law has. A law with a single version answers a list of one and is charged: “this law has never changed” is the answer you paid for. Reading a version’s text is a separate call at the body price (6 credits per page), the same as the current text. A request that fails validation (422) is never charged. A law that is not found (404) is never charged. A failure on our side (500, 503) is refunded.

Edge cases. A law that is in the registry but has no version row (its current version is not set, or it was withdrawn or merged into another law) answers 200 with versions: [], count: 0 and a note, and is not charged; it is never the 404 “no law carries this id”. One answer lists at most 100 versions, newest first; truncated: true says older versions exist that it does not show.

Id only. This route takes a sessionLawId, not a citation: resolve a citation once with GET /us/session-laws/{sessionLawId} and use the id it returns. A federal id (SAL_...) is a 404 (federal_session_law), as on /body.

What a version says. version is the number to send as version on /body. Numbers can have gaps: a version we recorded and never served or adopted is not listed. Exactly one listed version has isCurrent: true, and currentVersion repeats its number: it is the text a plain /body call serves. recordedAt dates our copy of the text, not the act (approvedDate on the law does that). totalChars and textSha256 identify the text: two versions with the same hash have the same text. citation, title and approvedDate are as that version recorded them, so a correction that fixed a title shows here.

The law-level textStatus, textReliability and reasonCode are the same fields, with the same meaning, as on /body. textReliability is omitted when no text of the law may be read, and reasonCode when the law is served and verified. To check that nothing changed under you, compare textSha256 here with the one you read; the cursor rules for an older version are on /body.

Example

curl "https://api.vaquill.ai/api/v1/us/session-laws/SSL_MN_2025S1_G_Y2025_C1/versions" \
  -H "Authorization: Bearer $VAQUILL_API_KEY"

# then read the first version's text, one page at the body price
curl "https://api.vaquill.ai/api/v1/us/session-laws/SSL_MN_2025S1_G_Y2025_C1/body?version=1" \
  -H "Authorization: Bearer $VAQUILL_API_KEY"

const id = "SSL_MN_2025S1_G_Y2025_C1";
const res = await fetch(`https://api.vaquill.ai/api/v1/us/session-laws/${encodeURIComponent(id)}/versions`, {
  headers: { Authorization: `Bearer ${process.env.VAQUILL_API_KEY}` },
});
const { versions, currentVersion } = await res.json();
const older = versions.filter((v) => !v.isCurrent && v.textAccess === "served");

Related endpoints

• GET /us/session-laws/{sessionLawId}/body reads the text of the current version, or of the one you name with version. It also takes includeUnverified=true for a law we hold back.
• GET /us/session-laws/{sessionLawId} is the law’s record (dates, sources, code sections affected, whether its text is held); it always describes the current version.
• GET /us/session-laws/changes is the registry’s change feed: a corrected entry there is how you learn that a copy of a law you hold may be stale, and this route is where you see what changed.
• GET /us/statutes/coverage says which sessions we hold and how complete each is, under each jurisdiction’s sessionLaws block.
• Federal session laws (the Statutes at Large, SAL_ ids) are not served here. Read them with GET /us/statutes/section/{actId}.

Nulls. A field of a version with no value (citation, title, approvedDate, totalChars, textSha256, textMethod, amendatoryMarkup, markupConvention) is null. textReliability and reasonCode on the law are absent, not null, when they do not apply. The examples here leave the nulls out.

Rate limits. Calls count against your key’s per-minute budget like every Data API route; a 429 carries Retry-After.