Skip to content

Read up to 100 documents in input order with per-item outcomes

POST
/v1/documents/batch

Full content requires legal:source:full-text. Input order and duplicates are preserved. Content exceeding the 16 MiB response budget returns response_too_large; retry those items individually.

object
documents
required
Array<object>
>= 1 items <= 100 items
object
id
required
string format: uuid
version_id
string format: uuid
include
Array<string>
<= 2 items unique items
Allowed values: text sections

Ordered results; content exceeding the batch byte budget is explicitly reported

object
results
required
Array<object>
object
id
required
string format: uuid
version_id
string format: uuid
status
required
string
Allowed values: found not_found response_too_large
document
object
id
required
string format: uuid
version_id
required
string format: uuid
document_type
required
string
canonical_key
required
string
title
required
string
metadata
required
object
court
string
location
string
section
string
number
string
year
integer
decision_date
string format: date
jurisdiction
string
language
string
subject
string
outcome
string
source_uri
required

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

string
content_sha256
required
string
/^[a-f0-9]{64}$/
text
string
sections
object
heading
string
facts
string
reasoning
string
disposition
string
conclusion
string

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
X-Request-ID
string format: uuid

Correlation identifier for support and tracing.

RateLimit-Limit
integer
>= 1

Maximum requests allowed in the current minute.

RateLimit-Remaining
integer

Requests remaining in the current minute.

RateLimit-Reset
integer

Seconds until the current minute window resets.

Missing or invalid OAuth access token

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
X-Request-ID
string format: uuid

Correlation identifier for support and tracing.

The client is disabled or lacks the required scope

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
X-Request-ID
string format: uuid

Correlation identifier for support and tracing.

Legal Core is temporarily 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
X-Request-ID
string format: uuid

Correlation identifier for support and tracing.

RateLimit-Limit
integer
>= 1

Maximum requests allowed in the current minute.

RateLimit-Remaining
integer

Requests remaining in the current minute.

RateLimit-Reset
integer

Seconds until the current minute window resets.