POST
/
retry
curl --request POST \
  --url https://api.ding.live/v1/retry \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "customer_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "authentication_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}'
{
  "authentication_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "approved",
  "created_at": "2023-11-07T05:31:56Z",
  "next_retry_at": "2023-11-07T05:31:56Z",
  "remaining_retry": 3
}

The V1 API is deprecated. Technical support will end by October 2025 and will be removed by April 2026. No new features nor functionality will be added to the V1 API. Please use the V2 Verify API instead. For more information refer to the V2 Migration Guide.

​
This endpoint is not required anymore.

Retries are now handled automatically for all apps created after 2024-05-22. You can still use this endpoint if you prefer to have more control over user retries.

How automatic retries work

Automatic retries use the Stateless Mode. It systematically re-uses an existing authentication flow if one is found and is not expired.

Stateless mode

Authorizations

​
x-api-key
string
header
required

Body

application/json
​
customer_uuid
string
required

Your customer UUID, which can be found in the API settings in the dashboard.

​
authentication_uuid
string
required

The authentication UUID that was returned when you created the authentication.

Response

200
application/json
OK
​
authentication_uuid
string

The UUID of the corresponding authentication.

​
status
enum<string>

The status of the retry. Possible values are:

  • approved - The retry was approved and a new code was sent.
  • denied - The retry was denied.
  • no_attempt - No attempt was sent yet, so a retry cannot be completed.
  • rate_limited - The authentication was rate limited and cannot be retried.
  • expired_auth - The authentication has expired and cannot be retried.
  • already_validated - The authentication has already been validated.
Available options:
approved,
denied,
no_attempt,
rate_limited,
expired_auth,
already_validated
Example:

"approved"

​
created_at
string
​
next_retry_at
string

The time at which the next retry will be available.

​
remaining_retry
integer

The number of remaining retries.

Required range: x >= 0
Example:

3