Cowdidocs
API ReferenceCurrent account activation

Resend the OTP for an in-flight activation

POST
/v1/user/accounts/current/activations/{activationId}/resend

Sends a new OTP for an activation that is still AWAITING_OTP. Requires an authenticated, active user. Returns 404 when the activation does not exist, belongs to another caller, or already moved past the OTP step. Repeated calls are throttled. A call inside the cooldown window returns 429.

Authorization

oauth2
AuthorizationBearer <token>

Create a client with POST /v1/oauth/clients, then exchange its credentials for an access token. AUTHORIZATION_CODE clients act on behalf of a signed-in user and always use PKCE; CLIENT_CREDENTIALS clients act as themselves. A client may only be granted scopes its creator already holds — read the grantable list from GET /v1/oauth/clients/scopes.

In: header

Path Parameters

activationId*string

Unique identifier of the current-account activation.

Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/user/accounts/current/activations/550e8400-e29b-41d4-a716-446655440000/resend"
Empty
{  "code": "BAD_REQUEST",  "description": "Bad Request"}
{  "code": "UNAUTHORISED",  "description": "Unauthorised"}
{  "code": "FORBIDDEN",  "description": "Forbidden"}
{  "code": "RATE_LIMIT_EXCEEDED",  "description": "Too Many Requests"}
{  "code": "INTERNAL_ERROR",  "description": "Internal Server Error"}

Confirm the OTP for an in-flight activation POST

Verifies the OTP code and moves the activation to `OTP_CONFIRMED`. Requires an authenticated, active user. The current account becomes `ACTIVE` once the wallet provider confirms the account opening by callback. Returns 404 when the activation does not exist, belongs to another caller, or is not `AWAITING_OTP`. Returns 422 when the caller's KYC status is no longer `APPROVED`. Returns 409 when the provider rejects the activation while the OTP is being confirmed.

Get the caller's current-account closure GET

Returns the caller's most recent current-account closure, in any lifecycle status. Requires an authenticated, active user. The result includes a `COMPLETED` closure even after the account stops appearing in account listings. Returns 404 when the caller has never started a closure.