Skip to content

Search global judgment, article and act representations

POST
/v1/search
object
configuration_id

Supported search configuration pinned by the calling project or task. Omission selects the current default once per request.

string format: uuid
query
required
string
>= 1 characters <= 4096 characters
filters

AND between fields; OR within lists. Authority codes match the stored court identifier, jurisdiction codes match stored jurisdiction. Unknown metadata does not match.

object
grades

Exact stored judgment grades. No inferred grade; unknown grades do not match.

Array<string>
>= 1 items <= 50 items unique items
year

Inclusive decision-year range for judgments, act-year range for acts and their articles. Unknown years do not match.

object
>= 1 properties
gte
integer
>= 1 <= 9999
lte
integer
>= 1 <= 9999
document_types
Array<string>
>= 1 items <= 2 items unique items
Allowed values: judgment legislation
authority_codes
Array<string>
>= 1 items <= 50 items unique items
jurisdiction_codes
Array<string>
>= 1 items <= 50 items unique items
decision_date
object
>= 1 properties
gte
string format: date
lt
string format: date
document_types
Array<string>
<= 2 items unique items
Allowed values: judgment legislation
limit
integer
default: 10 >= 1 <= 50
mode
string
default: semantic
Allowed values: hybrid lexical semantic
allow_lexical_fallback

Permit an explicitly degraded lexical result when query embedding fails.

boolean

Ranked global representations with readable source coordinates, not original-text quotes

object
configuration_id

Configuration used for this search, including lexical fallback.

string format: uuid
hits
required
Array<object>
object
referenced_by_document_id

Exact same-act reference appended after ranked results; not a reranked hit. At most six references are appended beyond the requested primary limit.

string format: uuid
representation_id
string format: uuid
representation_kind

Global discovery content is not an original-text passage or a verified quote.

string
Allowed values: judgment_summary article_text act_profile
embedding_profile_id
string format: uuid
chunk_id
string format: uuid
document_id
required
string format: uuid
canonical_key
required
string
document_type
required
string
source_version_id
required
string format: uuid
source_sha256
required
string
/^[a-f0-9]{64}$/
source_uri
required

Source reference retained by the snapshot; not necessarily a URL.

string
generation_id
string format: uuid
chunk_number
integer
content
required
string
score
required

Domain-specific reranker score, or retrieval score in an explicitly degraded response. Not a probability; do not compare scores across domains.

number format: double
engine
required
string
Allowed values: hybrid lexical semantic
degraded
required
boolean
degradation_reason
string
result_sha256
required

Fingerprint of returned citation coordinates and content, not a persisted search snapshot.

string
/^[a-f0-9]{64}$/

Invalid request

object
type
required
string format: uri
Example
https://kesita.ai/problems/bad-request
title
required
string
status
required
integer
detail
string
instance
string
request_id
string

Missing or invalid credentials

object
type
required
string format: uri
Example
https://kesita.ai/problems/bad-request
title
required
string
status
required
integer
detail
string
instance
string
request_id
string

Authenticated principal lacks the required authority

object
type
required
string format: uri
Example
https://kesita.ai/problems/bad-request
title
required
string
status
required
integer
detail
string
instance
string
request_id
string

Dependency unavailable

object
type
required
string format: uri
Example
https://kesita.ai/problems/bad-request
title
required
string
status
required
integer
detail
string
instance
string
request_id
string