Manual review

Reviews raised on your sessions. By default this lists only reviews whose verification is still awaiting a decision, which is what a queue means and what both consoles show. Pass status to ask for something narrower, including status=resolved to read cases that have already been decided. The response carries ids and decisions, never applicant data. Cursor-paginated, newest first. limit accepts 1 to 100 and defaults to 20. To walk further, set starting_after to the id of the last record on the page you just read. has_more tells you another page exists and next_cursor is the value to pass back; on the last page has_more is false and next_cursor is null. An unknown cursor is ignored and you get the first page. Review ids are UUIDs, so starting_after takes a UUID here rather than a prefixed id. Requires the verification:read permission on the calling key.

Query Parameters

Response Body

Record where a reviewer landed. approve and reject close the review: status becomes resolved, reviewed_at is stamped, and the verification moves to approved or rejected. review is not an outcome, it means the reviewer wants another look, so the item goes back to status queued with reviewed_at still null and keeps appearing in the queue.

A SETTLED CASE IS FINAL. Once a review has been approved or rejected, a second approve or reject does NOT overwrite it: it answers 409 REVIEW_ALREADY_DECIDED and carries the decision that was reached. Exactly one of two simultaneous deciders wins, which is what stops your back office and a reviewer in the console from both settling one applicant.

Deciding review is the one exception, and it is not an outcome: it REOPENS the case, returning the verification to manual_review and clearing its verdict, so the review and the verification never disagree about whether there is still work to do. If the outcome email for the decision being reversed has not been sent yet, it is dropped rather than delivered.

Requires the verification:create permission on the calling key, the same write capability that starts a verification, not verification:read as the listing does.

A case that a colleague, the TrustWix console or the auto-decide policy has already settled answers 409 REVIEW_ALREADY_DECIDED and carries the decision that was reached. Handle it as an outcome, not as a failure: it is the expected result of two people working one queue, and it is not retryable.

Path Parameters

Response Body