US Statutes

Which acts a state publisher lists against this section

Changed on

The state session laws a publisher's own tables list against one code section: which act added, amended or repealed it, when the act took effect, and what the publisher printed. Start from an actId (or a citation), then read the act at href, or its text at href plus /body.

Stage 1. This reads the code-section tables that state publishers print against their session laws ("sections affected") through a reverse lookup. It is never a complete amendment history: only acts we hold, in sessions we hold (coverage.sessionsHeld), whose table lists the section in the printed form we map. An empty enactments with supported: true means "no held table lists this section", not "this section was never amended". coverage.note says per jurisdiction what is not read. Rows are newest act first and one per act; the section record's own history field names only the latest amendment, so a section can show one act there and many here.

Two kinds of evidence, never blended. basis: publisher_sections_affected with matchQuality: as_printed comes from the publisher's table. In AR, LA, ME, MI, VT, WI there is no such table read, so the section's history credit line is read instead: basis: credit_line with matchQuality: credit_cite_unique means the credit cites a session law (citeAsPrinted, verbatim) that names exactly one act we hold, in the same state, in a year that fits. A citation that fits several acts, a special-session or list form, or an act we do not hold is dropped, not guessed. A credit-line row states no action (action: other).

Where it works. CA, DC, HI, KY, MO, MS, NE, UT, WA: the jurisdictions where the publisher's printed form was shown to map to our section numbers against real data on both sides. Any other jurisdiction (and any federal, regulation or constitution section) answers supported: false, an empty list, a reason and a coverage.note, and is not charged. Matching is on the whole number after folding case, spacing, dashes and the section sign (71-24,104 does not match 71-24,10); where a publisher qualifies a section by code (California, Hawaii, DC) the code must match too.

Cost: 1 credit per call. Refunded on a 404, on an unsupported jurisdiction or section, and on a failure (500, 503). A supported section whose answer is empty is charged, because "no held table lists it" is the answer you paid for. A citation in place of the id also pays the /resolve price when it resolves; a citation that resolves to nothing is refunded in full, that price included. creditsConsumed reports what was billed.

A row. sessionLawId and href name the act. action is added | amended | repealed | renumbered | other, mapped only where the publisher's legend is settled, and actionAsPrinted is always the publisher's own code. effectiveDates are the act's, not necessarily this section's. sectionAsPrinted, codeAsPrinted and actSectionAsPrinted are verbatim. An act whose table lists the section more than once with the same action is folded into one row, and printedEntryCount says how many entries it holds. An omnibus act is titled by every section it amends (California): such a title is shortened to the section you asked about, titleCompacted is true and sectionsTouchedCount says how many sections the title lists; the full title is at href. truncated is true past 200 rows.

Example

curl "https://api.vaquill.ai/api/v1/us/statutes/section/STATE_MS_T27_C71_S27-71-5/enactments" \
  -H "Authorization: Bearer $VAQUILL_API_KEY"

Related endpoints

  • GET /us/statutes/section/{actId}/changes is what our refreshes observed to the section.
  • GET /us/session-laws/{sessionLawId} reads an act from href; /body reads its text.
  • GET /us/statutes/coverage says which sessions we hold in each jurisdiction's sessionLaws block.
get/api/v1/us/statutes/section/{act_id}/enactments

Request

Path parameters

act_idstring required

Section identifier, e.g. USC_T42_C21_S1983 (42 U.S.C. § 1983). Take it from a /us/statutes/search, /resolve or /divisions result; do not assemble one. A citation such as 42 USC 1983 also works and adds the /resolve price (see GET /us/statutes/section/{actId}). State session laws (SSL_ ids) are read at /us/session-laws/{sessionLawId}.

Example:STATE_MS_T27_C71_S27-71-5

Headers

Idempotency-Keystring nullable

Optional. 16 to 255 visible ASCII characters (a UUIDv4 works). Repeating the same request with the same key replays the original 2xx response for 24 hours without charging again. The same key on a different request is rejected. With the account's cacheQueryDerivedData retention setting off, no body is stored and a retry answers 409 idempotency_replay_unavailable, still without a second charge.

Example:3f9c2a1e-7b44-4d0a-9c1e-5a6b7c8d9e0f

Response

The entries the publisher's tables list against the section, or supported: false (not charged). Not a complete history.

actIdstring required

The section's act_id as served, after any citation or copy damage was resolved.

jurisdictionstring nullable

Lowercase two-letter code of the section's jurisdiction. Null for a federal section.

supportedboolean required

True when this section's jurisdiction is one whose publisher table is mapped to the statutes section numbers and this section is in the form that mapping was proven on, or one whose credit lines are read for session-law citations: then enactments is an answer, even when it is empty, and the call is charged. False when it is not (see reason): enactments is empty, says nothing about the section, and the call is NOT charged.

reason'unsupported_jurisdiction' | 'not_a_state_code_section' | 'section_not_in_proven_form' | 'section_number_missing' | 'section_citation_mismatch' | 'code_unknown' | 'code_not_proven' nullable

Why supported is false. unsupported_jurisdiction: we do not read this jurisdiction's table (none is printed, or its form is not verified against our section numbers), see coverage.note. not_a_state_code_section: the section is not a state statute (a federal, regulation or constitution section). section_not_in_proven_form: the jurisdiction is read, but this section's stored number is not in a form the mapping was proven on, so it is not guessed at. section_number_missing: the stored section carries no number to look up. section_citation_mismatch: the stored section number and the stored citation disagree (or the citation is not in the printed shape), so neither is trusted. code_unknown / code_not_proven: the section sits in a code (California, Hawaii, DC) we cannot name, or one whose printed form was not proven against our section numbers. Null when supported is true.

countinteger

Entries returned in enactments.

truncatedboolean

True when more entries matched than are returned (the newest are kept). A section amended by that many acts is not a case we have met.

creditsConsumedinteger

Credits actually charged for this call, never the list price. 0 when supported is false (refunded) and on a failure. A citation sent in place of the act_id adds the /us/statutes/resolve price when it resolves; a citation that resolves to nothing is refunded in full, the /us/statutes/resolve price included.

processingTimeMsnumber

Server-side time for this request in milliseconds, excluding network transit. Not billed on.

Example response

{
  "actId": "STATE_MS_T27_C71_S27-71-5",
  "resolvedFrom": {
    "input": "26 U.S.C. § 1",
    "actId": "USC_T26_C1_S1",
    "via": "citation",
    "subsection": "(h)(11)",
    "matchLevel": "container",
    "container": {
      "kind": "chapter",
      "label": "U.S. Const. art. III",
      "childCount": 12,
      "children": [
        {
          "actId": "CONST_US_A3_S1",
          "citation": "U.S. Const. art. III, § 1",
          "status": "in_force"
        }
      ]
    },
    "repair": {
      "kind": "code_name",
      "cited": "Jud. Ct. Acts Law",
      "interpretedAs": "N.Y. Judiciary Law § 475",
      "alternatives": [
        {
          "actId": "STATE_NY_FCT_S475",
          "citation": "N.Y. Fam. Ct. Act § 475"
        }
      ]
    },
    "registerReference": {
      "citation": "36 Pa. Bull. 510",
      "state": "il",
      "kind": "page",
      "ruleCount": 2
    }
  },
  "jurisdiction": "ms",
  "supported": true,
  "enactments": [
    {
      "sessionLawId": "SSL_MS_2025R_G_C301",
      "href": "/api/v1/us/session-laws/SSL_MS_2025R_G_C301",
      "citation": "Regular Session, ch. 301",
      "title": "AN ACT TO AUTHORIZE A PERSON WHO IS THE HOLDER OF A WINE MANUFACTURER'S PERMIT",
      "sessionCode": "2025R",
      "approvedDate": "2025-03-17",
      "effectiveDates": [
        {
          "kind": "approved",
          "date": "2025-03-17",
          "dateAsPrinted": "March 17, 2025, 10:54 a.m.",
          "kindAsPrinted": "Presentment Date",
          "scopeAsPrinted": "CCP §871.20."
        }
      ],
      "action": "amended",
      "actionAsPrinted": "A",
      "sectionAsPrinted": "027-0071-0005",
      "codeAsPrinted": "RCW",
      "actSectionAsPrinted": "6",
      "citeAsPrinted": "PL 2019, c. 147",
      "basis": "publisher_sections_affected",
      "matchQuality": "as_printed",
      "identityConfidence": "single_source",
      "textStatus": "held",
      "enactmentOutcome": "signed",
      "printedEntryCount": 1
    }
  ],
  "count": 1,
  "coverage": {
    "jurisdiction": "ms",
    "sessionsHeld": [
      {
        "code": "2025R",
        "label": "2025 Regular Session",
        "status": "complete"
      }
    ],
    "note": "Mississippi: the Legislature's bill-status record lists Code sections in a zero-padded form. Entries the publisher prints as a list or range are not matched."
  },
  "creditsConsumed": 1,
  "processingTimeMs": 96.4
}

Changes

    • warning

      added the new code_not_proven enum value to the / response property for the response status

    • warning

      added the new code_unknown enum value to the / response property for the response status

    • warning

      added the new section_citation_mismatch enum value to the / response property for the response status

    • warning

      added the new section_number_missing enum value to the / response property for the response status

    • info

      added the non-success response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status