Search published legal sources
POST /v1/search
Performs a read-only search with no side effects. POST keeps potentially sensitive legal queries out of URLs, browser history, and routine proxy access logs. Responses must not be cached.
Authorizations
Section titled “Authorizations ”Request Body required
Section titled “Request Body required ”object
Search text. It is accepted in the request body to reduce accidental disclosure.
AND between fields; OR within lists. Authority codes match the stored court identifier, jurisdiction codes match stored jurisdiction. Unknown metadata does not match.
object
Exact stored judgment grades. No inferred grade; unknown grades do not match.
Inclusive decision-year range for judgments, act-year range for acts and their articles. Unknown years do not match.
object
object
Responses
Section titled “ Responses ”Ranked, bounded passages from published sources
object
object
Parent result that cites this same-act article; appended outside the primary ranking.
Present for global discovery results, which have no passage_id and are not verified quotations.
Reciprocal-rank score, not a probability.
Stable human-readable legal citation or canonical source key.
Passage text bounded to 2,000 Unicode characters.
object
Lowercase hexadecimal SHA-256 digest.
True when the service used a reduced-capability retrieval path.
Headers
Section titled “Headers ”Correlation identifier for support and tracing.
Maximum requests allowed in the current minute.
Requests remaining in the current minute.
Seconds until the current minute window resets.
Invalid request
object
Example
https://kesita.ai/problems/bad-requestHeaders
Section titled “Headers ”Correlation identifier for support and tracing.
Maximum requests allowed in the current minute.
Requests remaining in the current minute.
Seconds until the current minute window resets.
Missing or invalid OAuth access token
object
Example
https://kesita.ai/problems/bad-requestHeaders
Section titled “Headers ”Correlation identifier for support and tracing.
The client is disabled or lacks the required scope
object
Example
https://kesita.ai/problems/bad-requestHeaders
Section titled “Headers ”Correlation identifier for support and tracing.
Request quota exceeded
object
Example
https://kesita.ai/problems/bad-requestHeaders
Section titled “Headers ”Correlation identifier for support and tracing.
Seconds before the client should retry.
Maximum requests allowed in the current minute.
Requests remaining in the current minute.
Seconds until the current minute window resets.
Legal Core is temporarily unavailable
object
Example
https://kesita.ai/problems/bad-requestHeaders
Section titled “Headers ”Correlation identifier for support and tracing.
Maximum requests allowed in the current minute.
Requests remaining in the current minute.
Seconds until the current minute window resets.