Skip to content
Dockt Dockt DOCKT

Get decision

GET
/v1/decisions/{decisionId}
 
curl --request GET \
  --url https://api.dockt.com/v1/decisions/dec_example \
  --header 'Authorization: Bearer <token>'

Returns the immutable decision for an assessment, including applied policy releases and evaluated requirements.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
decisionId
required

Unique Dockt decision identifier.

string
/^dec_[A-Za-z0-9_]+$/

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Envelope for a single resource response.

Media type application/json

Envelope for a single resource response.

object
object
required
string
Allowed values: single
data
required

Immutable assessment decision with typed policy provenance and evidence requirements for one assessment input version.

object
object
required
string
Allowed values: decision
id
required

Unique Dockt decision identifier.

string
/^dec_[A-Za-z0-9_]+$/
assessment_id
required

Assessment identifier associated with a decision.

string
/^ast_[A-Za-z0-9_]+$/
workspace_id
required

Unique Dockt workspace identifier.

string
/^wsp_[A-Za-z0-9_]+$/
features_id
required

Features version used when the decision was created.

string
/^feat_[A-Za-z0-9_]+$/
assessment_input_version
required
greaterThanOrEqualTo(1)

A number greater than or equal to 1

integer
>= 1
decision
required

Dockt decision for an assessment based on available worker context and evidence.

string
Allowed values: incomplete compliant non_compliant review_required
signal
required

Customer-facing traffic-light signal derived from the semantic decision.

string
Allowed values: green yellow red
explanation
required
minLength(1)

A string at least 1 character(s) long

string
>= 1 characters
findings
required
Array<object>
object
id
required
minLength(1)

A string at least 1 character(s) long

string
>= 1 characters
code
required
minLength(1)

A string at least 1 character(s) long

string
>= 1 characters
scope
required
string
Allowed values: assessment document requirement
impact
required
string
Allowed values: informational incomplete review_required non_compliant
title
required
minLength(1)

A string at least 1 character(s) long

string
>= 1 characters
explanation
required
minLength(1)

A string at least 1 character(s) long

string
>= 1 characters
document_ids
required
Array<string>
requirement_codes
required
Array<string>
facts
required
Array<object>
object
id
required
minLength(1)

A string at least 1 character(s) long

string
>= 1 characters
code
required
minLength(1)

A string at least 1 character(s) long

string
>= 1 characters
subject
required
object
id
required
minLength(1)

A string at least 1 character(s) long

string
>= 1 characters
type
required
string
Allowed values: worker employer assignment credential
value
required
Any of:
string
resolution
required
string
Allowed values: resolved corroborated
assurance
required
string
Allowed values: low medium high
sources
required
Array<object>
object
kind
required
string
Allowed values: customer_input document external_source
code
required
minLength(1)

A string at least 1 character(s) long

string
>= 1 characters
document_ids
required
Array<string>
observed_at
required
Any of:

ISO 8601 date-time string.

string format: date-time
fresh_until
required
Any of:

ISO 8601 date-time string.

string format: date-time
documents
required
Array<object>
object
document_id
required
minLength(1)

A string at least 1 character(s) long

string
>= 1 characters
status
required
string
Allowed values: uploaded processing completed failed withdrawn
document_result
required
Any of:
string
Allowed values: valid review_required invalid
finding_ids
required
Array<string>
recommendation
required
Any of:

Typed review-assistance recommendation captured with a decision.

object
action
required
string
Allowed values: approve review reject request_update
confidence
required
lessThanOrEqualTo(1)

A number less than or equal to 1

number
<= 1
mode
required
string
Allowed values: shadow review_assist
authority_verification_status
required
Any of:
string
fraud_signal_summary
required
Array<string>
applied_packages
required
Array<object>

Exact executable compliance-package release applied to an assessment.

object
code
required
minLength(1)

A string at least 1 character(s) long

string
>= 1 characters
version
required
minLength(1)

A string at least 1 character(s) long

string
>= 1 characters
requirements
required
Array<object>

Policy-neutral evidence requirement and its current assessment status.

object
code
required
minLength(1)

A string at least 1 character(s) long

string
>= 1 characters
label
required
maxLength(120)

Human-readable name shown in Dockt and customer systems.

string
>= 1 characters <= 120 characters
reason
required
Any of:
minLength(1)

A string at least 1 character(s) long

string
>= 1 characters
status
required

Current result of evaluating one evidence requirement.

string
Allowed values: missing not_required satisfied
required
required
boolean
source_domain
required
minLength(1)

A string at least 1 character(s) long

string
>= 1 characters
package
required
Any of:

Exact executable compliance-package release applied to an assessment.

object
code
required
minLength(1)

A string at least 1 character(s) long

string
>= 1 characters
version
required
minLength(1)

A string at least 1 character(s) long

string
>= 1 characters
accepted_evidence_types
required
Array<string>
supporting_document_ids
required
Array<string>
pending_document_ids
required
Array<string>
review_document_ids
required
Array<string>
invalid_document_ids
required
Array<string>
model_version
required
Any of:
string
created_at
required

ISO 8601 date-time string.

string format: date-time
Example 
{
  "object": "single",
  "data": {
    "object": "decision",
    "id": "dec_example1042",
    "assessment_id": "ast_example1042",
    "workspace_id": "wsp_example1042",
    "features_id": "feat_example1042",
    "assessment_input_version": 3,
    "decision": "compliant",
    "signal": "green",
    "explanation": "The available evidence satisfies every evaluated requirement for this assessment version.",
    "findings": [],
    "facts": [
      {
        "id": "fact_example1042",
        "code": "person.name",
        "subject": {
          "id": "worker_example1042",
          "type": "worker"
        },
        "value": "Amina Diallo",
        "resolution": "corroborated",
        "assurance": "medium",
        "sources": [
          {
            "kind": "customer_input",
            "code": "assessment.worker",
            "document_ids": [],
            "observed_at": null,
            "fresh_until": null
          },
          {
            "kind": "document",
            "code": "document.holder_name",
            "document_ids": [
              "doc_example1042"
            ],
            "observed_at": "2026-08-23T09:30:18Z",
            "fresh_until": null
          }
        ]
      }
    ],
    "documents": [
      {
        "document_id": "doc_example1042",
        "status": "completed",
        "document_result": "valid",
        "finding_ids": []
      }
    ],
    "recommendation": null,
    "authority_verification_status": null,
    "fraud_signal_summary": [],
    "applied_packages": [
      {
        "code": "social_construction_be_v1",
        "version": "v1"
      }
    ],
    "requirements": [
      {
        "code": "identity.worker",
        "label": "Identity document",
        "reason": "Confirm the identity of the worker being assessed.",
        "status": "satisfied",
        "required": true,
        "source_domain": "social",
        "package": {
          "code": "social_construction_be_v1",
          "version": "v1"
        },
        "accepted_evidence_types": [
          "identity_document"
        ],
        "supporting_document_ids": [
          "doc_example1042"
        ],
        "pending_document_ids": [],
        "review_document_ids": [],
        "invalid_document_ids": []
      }
    ],
    "model_version": null,
    "created_at": "2026-08-23T09:31:00Z"
  }
}

400

Section titled “400 ”

The request did not match the expected schema

Media type application/problem+json

Standard error response with a stable status, human-readable detail, and optional validation errors.

object
type
required
string
title
required
string
status
required
number
detail
required
string
instance
required
Any of:

Request identifier that Dockt support can use to trace an API call.

string
errors

Structured request validation issues.

object
issues
required
Array<object>

One request validation issue with a stable field path and human-readable message.

object
path
required
Array
message
required
string
Example 
{
  "type": "https://docs.dockt.com/errors/invalid-request",
  "title": "Bad request",
  "status": 400,
  "detail": "The request did not match the expected schema.",
  "instance": "req_example1042"
}

401

Section titled “401 ”

Problem Details response for HTTP 401. The type URI is the stable machine-readable error code.

Media type application/problem+json

Standard error response with a stable status, human-readable detail, and optional validation errors.

object
type
required
string
title
required
string
status
required
number
detail
required
string
instance
required
Any of:

Request identifier that Dockt support can use to trace an API call.

string
errors

Structured request validation issues.

object
issues
required
Array<object>

One request validation issue with a stable field path and human-readable message.

object
path
required
Array
message
required
string
Example 
{
  "type": "https://docs.dockt.com/errors/missing-auth",
  "title": "Unauthorized",
  "status": 401,
  "detail": "Send a valid bearer token or browser session.",
  "instance": "req_example1042"
}

403

Section titled “403 ”

Problem Details response for HTTP 403. The type URI is the stable machine-readable error code.

Media type application/problem+json

Standard error response with a stable status, human-readable detail, and optional validation errors.

object
type
required
string
title
required
string
status
required
number
detail
required
string
instance
required
Any of:

Request identifier that Dockt support can use to trace an API call.

string
errors

Structured request validation issues.

object
issues
required
Array<object>

One request validation issue with a stable field path and human-readable message.

object
path
required
Array
message
required
string
Example 
{
  "type": "https://docs.dockt.com/errors/forbidden",
  "title": "Forbidden",
  "status": 403,
  "detail": "The authenticated principal does not have the required permission.",
  "instance": "req_example1042"
}

404

Section titled “404 ”

Problem Details response for HTTP 404. The type URI is the stable machine-readable error code.

Media type application/problem+json

Standard error response with a stable status, human-readable detail, and optional validation errors.

object
type
required
string
title
required
string
status
required
number
detail
required
string
instance
required
Any of:

Request identifier that Dockt support can use to trace an API call.

string
errors

Structured request validation issues.

object
issues
required
Array<object>

One request validation issue with a stable field path and human-readable message.

object
path
required
Array
message
required
string
Example 
{
  "type": "https://docs.dockt.com/errors/not-found",
  "title": "Not found",
  "status": 404,
  "detail": "The requested resource was not found in the authenticated scope.",
  "instance": "req_example1042"
}

409

Section titled “409 ”

Problem Details response for HTTP 409. The type URI is the stable machine-readable error code.

Media type application/problem+json

Standard error response with a stable status, human-readable detail, and optional validation errors.

object
type
required
string
title
required
string
status
required
number
detail
required
string
instance
required
Any of:

Request identifier that Dockt support can use to trace an API call.

string
errors

Structured request validation issues.

object
issues
required
Array<object>

One request validation issue with a stable field path and human-readable message.

object
path
required
Array
message
required
string
Example 
{
  "type": "https://docs.dockt.com/errors/conflict",
  "title": "Conflict",
  "status": 409,
  "detail": "The request conflicts with the current resource state.",
  "instance": "req_example1042"
}

422

Section titled “422 ”

Problem Details response for HTTP 422. The type URI is the stable machine-readable error code.

Media type application/problem+json

Standard error response with a stable status, human-readable detail, and optional validation errors.

object
type
required
string
title
required
string
status
required
number
detail
required
string
instance
required
Any of:

Request identifier that Dockt support can use to trace an API call.

string
errors

Structured request validation issues.

object
issues
required
Array<object>

One request validation issue with a stable field path and human-readable message.

object
path
required
Array
message
required
string
Example 
{
  "type": "https://docs.dockt.com/errors/validation",
  "title": "Validation failed",
  "status": 422,
  "detail": "Correct the invalid fields and send the request again.",
  "instance": "req_example1042",
  "errors": {
    "issues": [
      {
        "path": [
          "body",
          "worker",
          "nationality"
        ],
        "message": "Expected a two-letter country code."
      }
    ]
  }
}

429

Section titled “429 ”

Problem Details response for HTTP 429. The type URI is the stable machine-readable error code.

Media type application/problem+json

Standard error response with a stable status, human-readable detail, and optional validation errors.

object
type
required
string
title
required
string
status
required
number
detail
required
string
instance
required
Any of:

Request identifier that Dockt support can use to trace an API call.

string
errors

Structured request validation issues.

object
issues
required
Array<object>

One request validation issue with a stable field path and human-readable message.

object
path
required
Array
message
required
string
Example 
{
  "type": "https://docs.dockt.com/errors/rate-limit",
  "title": "Too many requests",
  "status": 429,
  "detail": "Wait for the Retry-After interval before retrying.",
  "instance": "req_example1042"
}

500

Section titled “500 ”

Problem Details response for HTTP 500. The type URI is the stable machine-readable error code.

Media type application/problem+json

Standard error response with a stable status, human-readable detail, and optional validation errors.

object
type
required
string
title
required
string
status
required
number
detail
required
string
instance
required
Any of:

Request identifier that Dockt support can use to trace an API call.

string
errors

Structured request validation issues.

object
issues
required
Array<object>

One request validation issue with a stable field path and human-readable message.

object
path
required
Array
message
required
string
Example 
{
  "type": "https://docs.dockt.com/errors/internal",
  "title": "Internal server error",
  "status": 500,
  "detail": "Retry the request safely or contact Dockt support with the request ID.",
  "instance": "req_example1042"
}