Search US federal + state law

Hybrid semantic + keyword search over every ingested provision. Returns ranked results with citations, headings, and snippets. Check /api/v1/coverage first to see which jurisdictions are searchable. (Costs 1 credit.)

get/api/v1/search

Request

Base URL: https://corpuslaw.us
URL: https://corpuslaw.us/api/v1/search
Auth: HTTP bearer

Query parameters

qstring required

Example:distillery permit requirements

Search query (natural language or keywords).

pageinteger

1-based page number.

limitinteger

Results per page (max 100).

mode'hybrid' | 'semantic' | 'keyword'

Retrieval mode. 'hybrid' fuses vector similarity with keyword search.

jurisdictionstring

Example:TX

Scope to a jurisdiction short code (e.g. TX, US, CA-SF) and its sub-jurisdictions. See /api/v1/coverage for codes.

codeBodystring

Scope to a single code body by UUID (from /api/v1/code-bodies).

facetsboolean

Include facet counts (jurisdiction/tag histograms). Off by default to save latency; most agents don't need them.

Response

Success

object required

Example response

{
  "results": "SearchResultItem[] — nodeId, citation, heading, jurisdiction, codeBody, snippet, score",
  "page": 1,
  "pageSize": 20,
  "total": 42,
  "tookMs": 87,
  "mode": "hybrid"
}

Changes

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