Resend OTP

Resend a One-Time Password (OTP) to a subject for credential approval, via email or SMS (depending on their contact type) with a code and a signing URL
One exact search query must be provided

The endpoint validates:

• The request is not canceled
• Maximum attempts have not been reached, only successful OTP sends count towards resend limits
• Sufficient time has passed since the last successful resend
• Billing restrictions apply

PATCH /request/resend/{requestId}

Resend OTP

cURL

curl --request PATCH \
  --url https://api.example.com/request/resend/{requestId}

200

{
  "success": true
}

Headers

API-Version · string

Pin responses to a specific API version (YYYY-MM-DD). When omitted, defaults to the version stored in your issuer config or today's date.

Pattern: ^\d{4}-\d{2}-\d{2}$

Example:

"2026-03-03"

Path Parameters

requestId · string · required

Unique identifier of the request.

Example:

"507f1f77bcf86cd799439011"

Query Parameters

contact · string

Contact value (email or phone)

Example:

"[e-mail]"

did · string

Public Decentralized Identifier (DID) of the user

Example:

"did:via:humanos:user-abc123"

internalId · string

Identifier to help you identify the user in your own system. We recommend using a unique value.

Example:

"internal-12345"

Response

200 - application/json

Returns a confirmation that the OTP was sent successfully via email or SMS.

success · boolean · required

Whether the operation was successful

Example:

true