Get decision

GET

/v1/decisions/{decisionId}

const url = 'https://api.dockt.com/v1/decisions/dec_example';
const options = {
  method: 'GET',
  headers: {'x-dockt-expected-workspace': 'wsp_example', Authorization: 'Bearer <token>'}
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://api.dockt.com/v1/decisions/dec_example \
  --header 'Authorization: Bearer <token>' \
  --header 'x-dockt-expected-workspace: wsp_example'

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

Authorizations

bearerAuth
sessionCookie

Parameters

Path Parameters

decisionId

required

Unique Dockt decision identifier.

string

Header Parameters

x-dockt-expected-user

Rejects the request with 401 unless the browser session belongs to this auth_user_id. This assertion does not grant authority.

string

>= 1 characters

x-dockt-expected-workspace

Unique Dockt workspace identifier.

Responses

200

Envelope for a single resource response.

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

required

Unique Dockt decision identifier.

string

assessment_id

required

Assessment identifier associated with a decision.

string

workspace_id

required

Unique Dockt workspace identifier.

assessment_input_version

required

integer

>= 1

effective_policy_snapshot_id

required

Any of:

string
null

Immutable compiled policy composition used for one assessment input.

string

effective_policy_content_hash

required

Any of:

string
null

string

/^sha256:/

trigger

required

string

Allowed values: initial input_changed scheduled_monitoring policy_changed manual evaluation_engine_changed

universe_run_id

required

Any of:

string
null

Frozen Universe run used to create a decision.

string

universe_version

required

Any of:

integer
null

integer

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

string

>= 1 characters

findings

required

Array<object>

object

required

string

>= 1 characters

code

required

string

>= 1 characters

scope

required

string

Allowed values: assessment document requirement

impact

required

string

Allowed values: informational incomplete review_required non_compliant

title

required

string

>= 1 characters

explanation

required

string

>= 1 characters

document_ids

required

Array<string>

requirement_codes

required

Array<string>

facts

required

Array<object>

object

required

string

>= 1 characters

code

required

string

>= 1 characters

subject

required

object

required

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

Known values: customer_input, document, external_source. New values may appear; preserve unfamiliar values and use a safe fallback.

string

>= 1 characters

code

required

string

>= 1 characters

document_ids

required

Array<string>

observed_at

required

Any of:

string
null

ISO 8601 date-time string.

string format: date-time

fresh_until

required

Any of:

string
null

ISO 8601 date-time string.

string format: date-time

documents

required

Array<object>

object

document_id

required

string

>= 1 characters

status

required

string

Allowed values: uploaded processing completed failed withdrawn

document_result

required

Any of:

string
null

string

Allowed values: valid review_required invalid

finding_ids

required

Array<string>

recommendation

required

Any of:

object
null

Typed review-assistance recommendation captured with a decision.

object

action

required

string

Allowed values: approve review reject request_update

confidence

required

number

<= 1

mode

required

string

Allowed values: shadow review_assist

authority_verification_status

required

Any of:

string
null

string

fraud_signal_summary

required

Array<string>

applied_packages

required

Array<object>

Exact executable compliance-package release applied to an assessment.

object

code

required

string

>= 1 characters

version

required

string

>= 1 characters

requirements

required

Array<object>

Policy-neutral evidence requirement and its current assessment status.

object

code

required

string

>= 1 characters

label

required

Human-readable name shown in Dockt and customer systems.

string

>= 1 characters <= 120 characters

reason

required

Any of:

string
null

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

string

>= 1 characters

package

required

Any of:

object
null

Exact executable compliance-package release applied to an assessment.

object

code

required

string

>= 1 characters

version

required

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>

policy_rules

required

Array<object>

Deterministic result for one sourced rule in the frozen effective policy.

object

ref

required

object

source

required

string

Allowed values: compliance_package job_profile workspace

source_id

required

string

>= 1 characters

rule_code

required

string

>= 1 characters

label

required

string

>= 1 characters

enforcement

required

string

Allowed values: required advisory waived

status

required

string

Allowed values: not_applicable satisfied unmet unresolved review_required

baseline_rule_hash

required

string

>= 1 characters

effective_rule_hash

required

string

>= 1 characters

applied_policy_adjustments

required

Array<object>

Auditable difference between a selected baseline rule and its effective Workspace treatment.

object

target

required

object

source

required

string

Allowed values: compliance_package job_profile workspace

source_id

required

string

>= 1 characters

rule_code

required

string

>= 1 characters

operation

required

string

Allowed values: change_enforcement require_also accept_also apply_only_when apply_also_when set_qualification_comparison_policy

direction

required

string

Allowed values: strengthened weakened waived

reason

required

Any of:

string
null

string

original_rule_hash

required

string

>= 1 characters

effective_rule_hash

required

string

>= 1 characters

qualification_comparisons

required

Array<object>

Source-grounded coverage summary for one candidate against the frozen customer requirement; it is not equivalence.

object

required

Assessment-scoped semantic qualification comparison.

string

policy_rule_ref

required

object

source

required

string

Allowed values: compliance_package job_profile workspace

source_id

required

string

>= 1 characters

rule_code

required

string

>= 1 characters

requirement_key

required

string

>= 1 characters

candidate_definition_ids

required

Array<string>

conclusion

required

string

Allowed values: coverage_sufficient_in_principle coverage_partial coverage_insufficient coverage_unknown

matching_points

required

Array<object>

object

summary

required

string

>= 1 characters

source_refs

required

Array<string>

differences

required

Array<object>

object

summary

required

string

>= 1 characters

source_refs

required

Array<string>

missing_information

required

Array<object>

object

summary

required

string

>= 1 characters

source_refs

required

Array<string>

model_version

required

Any of:

string
null

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",
    "assessment_input_version": 3,
    "effective_policy_snapshot_id": "eps_example1042",
    "effective_policy_content_hash": "sha256:example1042",
    "trigger": "initial",
    "universe_run_id": "urun_example1042",
    "universe_version": 4,
    "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": []
      }
    ],
    "policy_rules": [],
    "applied_policy_adjustments": [],
    "qualification_comparisons": [],
    "model_version": null,
    "created_at": "2026-08-23T09:31:00Z"
  }
}

400

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

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:

string
null

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

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

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:

string
null

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

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

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:

string
null

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

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

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:

string
null

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

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

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:

string
null

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

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

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:

string
null

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",
          "inputs",
          "3",
          "value"
        ],
        "message": "Expected a two-letter country code."
      }
    ]
  }
}

429

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

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:

string
null

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

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

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:

string
null

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"
}

503

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

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:

string
null

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

{
  "instance": "req_example1042"
}

Get decision

Authorizations

Parameters

Path Parameters

Header Parameters

Responses

200

Example

400

Example

401

Example

403

Example

404

Example

409

Example

422

Example

429

Example

500

Example

503

Example

Analytics cookies