List assessments

GET

/v1/assessments

const url = 'https://api.dockt.com/v1/assessments?limit=20&status=created';
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/assessments?limit=20&status=created' \
  --header 'Authorization: Bearer <token>' \
  --header 'x-dockt-expected-workspace: wsp_example'

Lists assessments in the active workspace. Requires assessments:read and decisions:read because collection items include latest decision summaries.

Authorizations

bearerAuth
sessionCookie

Parameters

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.

Query Parameters

limit

Maximum number of resources to return. Defaults to 20 and cannot exceed 100.

integer

default: 20 >= 1 <= 100

cursor

Opaque next_cursor value returned by the previous page.

string

status

Lifecycle state for an assessment.

string

Allowed values: created documents_pending processing assessed

external_id

string

Case-insensitive search. Matches part of the external ID or the worker’s first, last, or full name, or an exact assessment ID.

string

>= 1 characters <= 200 characters

Responses

200

Envelope for a paginated collection response.

application/json

Envelope for a paginated collection response.

object

object

required

string

Allowed values: list

data

required

Array<object>

Compact assessment representation returned from collection reads.

object

object

required

string

Allowed values: assessment

required

Unique Dockt assessment identifier.

string

external_id

required

Any of:

string
null

string

job

required

Any of:

object
null

Namespaced customer job identifier resolved through the active Job Profile revisions.

object

namespace

required

string

>= 1 characters

external_id

required

string

>= 1 characters

status

required

Lifecycle state for an assessment.

string

Allowed values: created documents_pending processing assessed

worker

required

Any of:

object
null

Read-only summary of the worker identity Dockt can establish from the available information. All known nationalities are kept. Fields that remain unknown or conflicting are omitted.

object

name

string

>= 1 characters

nationalities

Array<string>

first_name

string

>= 1 characters

last_name

string

>= 1 characters

date_of_birth

ISO 8601 calendar date string.

string format: date

input_request_count

required

integer

has_satisfied_requirements

Whether at least one evidence requirement is satisfied.

boolean

setup_incomplete

Whether the latest decision reports incomplete assessment setup.

boolean

review_required

required

boolean

monitoring

required

Customer-safe periodic monitoring state for an assessment.

object

enabled

required

boolean

status

required

string

Allowed values: disabled active stopped ended point_in_time

next_reassessment_at

required

Any of:

string
null

ISO 8601 date-time string.

string format: date-time

monitoring_ends_at

required

Any of:

string
null

ISO 8601 date-time string.

string format: date-time

last_reassessed_at

required

Any of:

string
null

ISO 8601 date-time string.

string format: date-time

latest_decision

required

Any of:

object
null

Current decision summary for an assessed assessment.

object

decision_id

required

Unique Dockt decision identifier.

string

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

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

created_at

required

ISO 8601 date-time string.

string format: date-time

updated_at

required

ISO 8601 date-time string.

string format: date-time

has_more

required

boolean

next_cursor

required

Any of:

string
null

string

Example

{
  "object": "list",
  "data": [
    {
      "object": "assessment",
      "id": "ast_example",
      "status": "created",
      "worker": {
        "date_of_birth": "1990-05-17"
      },
      "monitoring": {
        "status": "disabled",
        "next_reassessment_at": "2026-08-06T09:30:00Z",
        "monitoring_ends_at": "2026-08-06T09:30:00Z",
        "last_reassessed_at": "2026-08-06T09:30:00Z"
      },
      "latest_decision": {
        "decision_id": "dec_example",
        "decision": "incomplete",
        "signal": "green",
        "recommendation": {
          "action": "approve",
          "mode": "shadow"
        }
      },
      "created_at": "2026-08-06T09:30:00Z",
      "updated_at": "2026-08-06T09:30: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"
}

List assessments

Authorizations

Parameters

Header Parameters

Query Parameters

Responses

200

Example

400

Example

401

Example

403

Example

404

Example

409

Example

422

Example

429

Example

500

Example

503

Example

Analytics cookies