Skip to main content
PATCH
/
v3
/
session
/
{sessionId}
/
update-status
curl --request PATCH \
  --url https://verification.didit.me/v3/session/{sessionId}/update-status/ \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "new_status": "Approved",
  "comment": "All verifications passed manual review"
}
'
{
  "session_id": "11111111-2222-3333-4444-555555555555"
}

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
sessionId
string
required

Body

application/json
​
new_status
enum<string>
required

The new status to set for the session. Use Approved or Declined for final decisions, or Resubmitted to request the user to redo specific failed/in-review steps.

Available options:
Approved,
Declined,
Resubmitted
​
comment
string

A comment explaining the reason for the status change. For example Duplicated user.

​
send_email
boolean
default:false

Whether to send an email notification to the user about the status change. For Resubmitted status, the email includes the verification link and reasons for resubmission.

​
email_address
string<email>

The email address to send the notification to. Required when send_email is true.

​
email_language
enum<string>
default:en

The language for the email notification. Defaults to 'en' (English).

Available options:
en,
es,
fr,
de,
pt,
it,
ar,
bg,
bn,
ca,
cs,
da,
el,
et,
fa,
fi,
he,
hi,
hr,
hu,
hy,
id,
ja,
ka,
ko,
lt,
lv,
mk,
ms,
nl,
no,
pl,
pt-BR,
ro,
ru,
sk,
sl,
so,
sr,
sv,
th,
tr,
uk,
uz,
vi,
zh,
zh-CN,
zh-TW

Response

Status updated successfully