Skip to main content
POST
/
retry
Perform a 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",
  "created_at": "2023-11-07T05:31:56Z",
  "next_retry_at": "2023-11-07T05:31:56Z",
  "remaining_retry": 1
}
The V1 API is deprecated. Starting November 1st 2025, no support will be provided for the V1 API and it 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.
V2 equivalent: In V2, retries are handled by replaying the same Create or retry a verification request within the verification window. There is no dedicated retry endpoint.

​
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.
Dashboard screenshot

Authorizations

​
x-api-key
string
header
required

Body

application/json
​
customer_uuid
string<uuid>
required

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

​
authentication_uuid
string<uuid>
required

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

Response

OK

​
authentication_uuid
string<uuid>

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<date-time>
​
next_retry_at
string<date-time>

The time at which the next retry will be available.

​
remaining_retry
integer

The number of remaining retries.

Required range: x >= 0
Example:

3