List + filter the general US law corpus

Statutes, regulations and federal executive instruments at title/chapter/part level, each with its official citation, status, effective date, the official government source URL, and a many-to-many classification into 33 branches and 227 subcategories. Records LINK to the official text; they do not reproduce it.

METERED ON RECORDS SERVED, not just on requests. A request cap stops a fast client; a record cap stops a patient one, and only the second is priced against the size of the corpus. Every response carries meta.record_budget with what is left in the day and 30-day windows; exhausting it returns 429 record_budget_exceeded (distinct from 429 rate_limited).

PRODUCT SCOPE: this endpoint belongs to the US Law Platform. A key licensed only for AI Law Tracker (product: ai_law) is NOT refused here — it is served at the PUBLIC (keyless) capability level, the same few records any anonymous caller gets. The response headers say so explicitly: X-ALT-Product (what your key holds), X-ALT-Product-Surface (us_law) and X-ALT-Product-Scope (in_product | out_of_product). Your request rate and daily/monthly quota are NEVER degraded — those are metered per key wherever you call. What degrades is capability: page size, pagination depth, field envelope and the record budget.

get/us-law

Request

  • Base URL: https://ai-law-tracker.com/api/v1
  • URL: https://ai-law-tracker.com/api/v1/us-law
  • Auth: one of:
    • none
    • API key in header X-API-Key
    • HTTP bearer

Query parameters

branchstring

PRIMARY branch id from /us-law/taxonomy. Matches only records whose primary classification is this branch - narrower than branch_any, and usually not what you want for a coverage question.

branch_anystring

Branch id matched against ANY assignment, primary or secondary. Records are genuinely multi-branch (HIPAA is health law AND privacy law), so this is the complete answer: branch=health_law matches 1,942 records, branch_any=health_law matches 2,852.

domainstring

Subcategory id matched against ANY assignment, primary or secondary.

domain_primarystring

Subcategory id, primary classification only.

jurisdictionstring

Jurisdiction slug, e.g. california. Comma-separated for several: california,new-york.

jurisdiction_levelstring

federal and/or state, comma-separated.

instrument_typestring

Document KIND: statute, regulation, executive_order, proclamation, agency_guidance, constitution, presidential_memorandum... Comma-separated for several. SCARCE types (executive orders, proclamations, agency guidance and other presidential instruments - about 3% of the corpus) are content-gated below the top tiers: the response is a small real SAMPLE, reported as meta.sampled with meta.sampled_reason "scarce_instrument_type", never a silent truncation. Listing a scarce type alongside a common one still arms that gate.

statusstring

in_force, superseded, repealed, enacted, unknown. Comma-separated for several.

in_forceboolean

Operative law only (or only non-operative).

is_bindingboolean

Whether the instrument carries the force of law. false selects the guidance-type corpus.

effective_fromstring date

Effective on or after this date (YYYY-MM-DD).

effective_tostring date
enacted_fromstring date
enacted_tostring date
repealed_fromstring date
repealed_tostring date
retrieved_sincestring date-time

Records WE re-fetched on or after this time. This is our freshness stamp, NOT a claim that the law changed then - for that see /us-law/records/{record_uid}/history.

verified_sincestring date-time

Records WE re-verified on or after this time. Same caveat as retrieved_since.

citationstring

Exact citation match, case-insensitive - e.g. 45 CFR Part 164. Use citation_prefix to widen.

citation_prefixstring

Citation starts-with, e.g. 45 CFR for everything under that part.

identifierstring

Exact identifier match, e.g. Pub. L. 117-58.

record_uidstring

Fetch specific records by uid; comma-separated, up to 100. The batch form of /us-law/records/{record_uid}.

qstring

Substring match on title / short title / citation. For ranked full text over the summary as well, use /us-law/search.

sort'effective_date' | 'enacted_date' | 'repealed_date' | 'retrieved_at' | 'last_verified_at' | 'title' | 'citation'
order'asc' | 'desc'
limitinteger

Clamped to your tier cap; the clamp is reported in meta.gated.

offsetinteger

Clamped to your tier pagination depth.

Response

Matching records, plus the record-budget state.

api_versionstring
attributionstring

Changes

No recorded changes to this operation across all 1 revision of this API.