API reference

Checks

Individual checks of a case with outcomes, reasons and evidence.

Get a check

GET/v1/checks/{check_id}

Scopes
checks:read

Parameters

FieldTypeRequired
check_idpathstring (uuid)yes

Responses

  • 200CheckResult
  • 400
  • 401
  • 403
  • 404
  • 409
  • 412
  • 413
  • 415
  • 422
  • 428
  • 429
  • 503

Get a screening explanation

GET/v1/checks/{check_id}/screening-explanation

Scopes
checks:read

Parameters

FieldTypeRequired
check_idpathstring (uuid)yes

Responses

  • 200ScreeningExplanation
  • 400
  • 401
  • 403
  • 404
  • 409
  • 412
  • 413
  • 415
  • 422
  • 428
  • 429
  • 503

Rerun a screening check

POST/v1/cases/{case_id}/checks/{kind}/rerun

Scopes
checks:rerun
Required header
Idempotency-Key
Required header
If-Match

Repeats screening of a case under manual review without refuting a match, for example when the list snapshot became stale before the decision. Only a screening kind executed by the case policy; If-Match is the case ETag. Creates a new attempt over the current active snapshots with its own explanation package; the review task stays open and an approval still requires the new result to pass.

Parameters

FieldTypeRequired
case_idpathstring (uuid)yes
kindpathenum: person_screening, company_screeningyes

Request bodyReasonAction

FieldTypeRequired
reason_codestringyes
notestringno

Responses

  • 201CheckResult
  • 400
  • 401
  • 403
  • 404
  • 409
  • 412
  • 413
  • 415
  • 422
  • 428
  • 429
  • 503