---
title: "Confirm a verification code"
method: POST
path: "/v2/senders/registrations/{registration_id}/verifications/confirmation"
tags: ["Senders"]
---

# Confirm a verification code

`POST /v2/senders/registrations/{registration_id}/verifications/confirmation`

Confirms a sender registration by submitting the verification code.
On success, the verification `status` becomes `CONFIRMED` and the sender registration `status` becomes `VERIFIED`.
If you exceed the allowed attempts, the verification becomes `FAILED`. Request a new verification code to try again.

## Path parameters

- `registration_id` string, uuid, required

## Request body

- VerificationConfirmRequest — Request body for confirming a verification code.
  - `code` string, required — The verification code received via the selected verification method.

## Response `200`

Successful response containing the verification confirmation details.

- object
  - `data` object, required — The result of a successful verification code confirmation.
    - `registration_id` string, uuid, required — The registration this verification belongs to.
    - `status` 'SENT' | 'CONFIRMED' | 'EXPIRED' | 'FAILED', required — Status of a sender registration verification.
    - `verified_at` string, date-time, required — Timestamp in RFC3339 format (e.g., 2025-08-26T10:32:00Z) when the verification was confirmed.
  - `request` object — Optional metadata (e.g. requestId, traceId)
  - `meta` object — Optional pagination, feature flags, etc.

## Other responses

- `400` — 400 response specific to the verification confirmation endpoint. The response includes `attempts_remaining` as a structured integer field alongside the standard `detail` and `issues` fields, so clients can display the remaining attempt count without string parsing.
- `401` — Unauthorized
- `404` — Not Found
- `409` — Conflict
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.net/kudosity/apis/transmit-sms-api.md) · [All operations](https://skmtc.net/kudosity/apis/transmit-sms-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kudosity/transmit-sms-api/revisions/9f6c34b849af/schema)