Skip to content

Read a published document, optionally pinned to a version

GET
/v1/documents/{id}

Metadata by default. include=text,sections requires legal:source:full-text in both token and client registration.

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

Document metadata and explicitly requested content

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.

Document or requested version not found

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.

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.