State Session Laws
list_session_lawsList a US state's session laws by jurisdiction and filter by session, approval/effective dates, text availability, series, or enactment outcome to find enacted acts or vetoed measures.
Instructions
List one US state's session laws (acts as enacted, v1 covers state acts only). jurisdiction is REQUIRED, a two-letter state code. Filter by session, approval date or effective date, for example everything taking effect on a date. Rows include laws whose text is not served (textStatus not_held or withheld); pass hasText=true for readable ones. Page with cursor = nextCursor. An empty page is still charged.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"jurisdiction": "<jurisdiction>"
},
"name": "list_session_laws"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Only laws whose title or printed bill number contains this text, case-insensitive. A plain substring, with no stemming or ranking (use search_session_laws for that). Bill numbers match as printed (`S.F.No. 1552`). 3 to 100 characters. | |
| isLaw | No | true: only measures that are law. false: only numbered measures that are not (a vetoed bill, a pocket veto). Omit for both. A measure whose outcome is unsettled matches neither; use enactmentOutcome for those. | |
| limit | No | Rows per page, 1 to 200; default 50. A page costs the same however many rows it holds, so a larger `limit` is cheaper per law. Outside the range is a 422. | |
| order | No | `asc` (default) sorts by session code, then law id; `desc` is the exact reverse (newest session first). Law ids sort as text. Keep the same `order` across pages: changing it with a cursor is a 422. | asc |
| cursor | No | The previous page's nextCursor, unchanged, sent with the same filters (limit may change). A cursor we did not issue, an expired one or one sent with different filters is a 422; restart without it. Omit for the first page. | |
| series | No | Only laws in these numbering series (OR), as a result's series reports it; `general` is most states' ordinary chapter sequence. Not every state uses every series. An unknown value is a 422; a valid one that matches nothing is an empty, charged page. | |
| hasText | No | true: only laws whose text is served (textStatus held), the ones get_session_law_body returns. false: only laws without served text. Omit for both. Combines with textStatus by AND. | |
| session | No | Only laws from this session, with the code exactly as session.code reports it (`2025R` regular, `2025S1` first special). Case-sensitive. A code that matches nothing returns an empty page, which is charged. | |
| approvedTo | No | Only laws approved (signed) on or before this date. Format `YYYY-MM-DD`, inclusive; it must be a real calendar date (`2025-02-30` is a 422). Like `approvedFrom`, it matches a derived `approvedDate` too. | |
| textStatus | No | Only laws with this text status: `held` (served), `withheld` (held but kept back for a measured defect), `not_held` (known, no text) or `pending` (collected, not yet verified). Omit for all. | |
| effectiveTo | No | Only laws with an effective date on or before this date. Format `YYYY-MM-DD`, inclusive; it must be a real calendar date (`2025-02-30` is a 422). Overlap rule as for `effectiveFrom`. An end before `effectiveFrom` is a 422 (never charged). | |
| approvedFrom | No | Only laws approved (signed) on or after this date, `YYYY-MM-DD`, inclusive. A law with no printed approval date, or a derived one (approvedDateDerived: true), never matches. Pair with approvedTo; an end before the start is a 422. | |
| jurisdiction | Yes | REQUIRED. The two-letter code of the state to list, `dc` or `pr`, case-insensitive; one jurisdiction per call. `federal` or an unknown code is a 422. A state with no held session laws returns an empty page with a coverage note, not charged. | |
| updatedSince | No | Only laws whose record changed on or after this date (`YYYY-MM-DD`, midnight UTC, by updatedAt), for sync jobs. A day with no change returns an empty page, which is charged. | |
| effectiveFrom | No | Only laws with an effective date on or after this date, `YYYY-MM-DD`, inclusive; a law matches when its effectiveFirst to effectiveLast span overlaps the window. A law with no held effective date never matches, though it may be in force. For one day, send it as both bounds. | |
| instrumentType | No | Only these kinds of measure (OR); `act` is an ordinary law. An unknown value is a 422; a valid kind that matches nothing is an empty, charged page. | |
| Idempotency-Key | No | Optional, 16 to 255 visible ASCII characters (a UUIDv4 is ideal). A retry with the same key and request replays the original 2xx for 24 hours without charging again; the same key with a different request is rejected. | |
| enactmentOutcome | No | Only laws with one of these outcomes (OR), for example `vetoed` or `pocket_veto`, as enactmentOutcome reports it. An unknown value is a 422; a valid outcome that matches nothing is an empty, charged page. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||