Skip to main content
GET
Get a capability request

Authorizations

Authorization
string
header
required

The data.access_token value from Get access token.

Headers

X-Api-Version
string

Version applied to this request. It wins over your account's pinned version — see Versioning.

Example:

"2026-06-01"

Path Parameters

request_id
string<uuid>
required

The id the request was opened with.

Response

The request.

A request that a sub-client be enabled for a capability — see The capability request object.

id
string<uuid>

The request's identifier.

user_id
string<uuid>

The sub-client the request is for.

capability
string

The capability requested — see Values.

status
string

Where the request stands. Available options: requested, submitted, approved, rejected, cancelled — see Values.

requirements_version
string

Identifies the list of requirements the request was opened against. It changes when that list changes.

The link where the sub-client answers the requirements.

Only while status is requested.

When verification_link stops working, ISO 8601. Request the capability again with Request a capability for a fresh link.

evidence
object

What the sub-client sent, once Kira has kept a copy of it. The answers and files themselves are never returned.

review
object

The latest review outcome. Absent until compliance has reviewed the request.

grant
object

The capability the approval granted. Only on an approved request.

cancel_reason
string

Why the request was cancelled. Only on a cancelled request — see Values.

created_at
string<date-time>

When the request was opened, ISO 8601.

submitted_at
string<date-time> | null

When the sub-client sent its answers, ISO 8601. null until then.

decided_at
string<date-time> | null

When the request was approved or rejected, ISO 8601. null until then.