---
title: "Search US federal + state law"
method: GET
path: "/api/v1/search"
tags: ["Search"]
---

# Search US federal + state law

`GET /api/v1/search`

## Request

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

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.)

## Query parameters

- `q` string, required
- `page` integer
- `limit` integer
- `mode` 'hybrid' | 'semantic' | 'keyword'
- `jurisdiction` string
- `codeBody` string
- `facets` boolean

## Response `200`

Success

- object

## Other responses

- `401`: Missing or invalid API key.
- `402`: No credits remaining.
- `403`: Key lacks the required scope.
- `422`: A required parameter is missing or invalid.
- `429`: Rate limit exceeded. Respect `Retry-After`.

---

[API](https://skmtc.dev/corpuslaw/apis/corpus-public-api.md) · [All operations](https://skmtc.dev/corpuslaw/apis/corpus-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/corpuslaw/apis/corpus-public-api/revisions/5fb5626f7de6?raw)