Skip to content
Dockt Dockt DOCKT

List assessments

GET
/v1/assessments
 
curl --request GET \
  --url 'https://api.dockt.com/v1/assessments?limit=20&status=created' \
  --header 'Authorization: Bearer <token>'

Lists assessments in the active workspace.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters ”
limit

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

integer
default: 20 >= 1 <= 100
Example 
20

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

cursor

Opaque next_cursor value returned by the previous page.

string

Opaque next_cursor value returned by the previous page.

status

Lifecycle state for an assessment.

string
Allowed values: created documents_pending processing assessed
external_id
string

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Envelope for a paginated collection response.

Media type 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
id
required

Unique Dockt assessment identifier.

string
/^ast_[A-Za-z0-9_]+$/
external_id
required
Any of:
string
external_profile
required
Any of:
string
status
required

Lifecycle state for an assessment.

string
Allowed values: created documents_pending processing assessed
worker
required

Portable worker identity snapshot. Policy and assignment context is supplied separately.

object
first_name
required
minLength(1)

Worker legal first name.

string
>= 1 characters
last_name
required
minLength(1)

Worker legal last name.

string
>= 1 characters
date_of_birth
required

ISO 8601 calendar date string.

string format: date
nationality
required
maxLength(2)

Worker nationality as an ISO 3166-1 alpha-2 country code.

string
>= 2 characters <= 2 characters
input_request_count
required
greaterThanOrEqualTo(0)

A non-negative number

integer
review_required
required
boolean
latest_decision
required
Any of:

Current decision summary for an assessed assessment.

object
decision_id
required

Unique Dockt decision identifier.

string
/^dec_[A-Za-z0-9_]+$/
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:

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
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
Example 
{
  "object": "list",
  "data": [
    {
      "object": "assessment",
      "id": "ast_example",
      "status": "created",
      "worker": {
        "date_of_birth": "1990-05-17"
      },
      "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

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