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

# Request a verification code

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

Requests a verification code for a sender registration. This endpoint supports registrations with `type` = `PERSONAL_MOBILE_NUMBER` only.

  - The API delivers the code to the registered sender number using the selected `method`, such as `SMS`.
  - Codes expire after 30 minutes.
  - You have a maximum of 5 attempts to confirm the code.

## Path parameters

- `registration_id` string, uuid, required

## Request body

- VerificationRequest — Request body for requesting a verification code.
  - `method` 'SMS', required — Method used to deliver the verification code.
  - `originating_sender` string, required — Verified sender owned by the account that the API uses to send the verification code.

## Response `201`

Successful response containing the verification details.

- object
  - `data` object, required — A verification record for a sender registration.
    - `registration_id` string, uuid, required — The registration this verification belongs to.
    - `method` 'SMS', required — Method used to deliver the verification code.
    - `originating_sender` string, required — The sender number used to deliver the verification code.
    - `status` 'SENT' | 'CONFIRMED' | 'EXPIRED' | 'FAILED', required — Status of a sender registration verification.
    - `expires_at` string, date-time, required — Timestamp in RFC3339 format (e.g., 2025-08-26T10:35:00Z) when the verification code expires.
    - `attempts_remaining` integer, required — Number of remaining attempts to submit the verification code.
  - `request` object — Optional metadata (e.g. requestId, traceId)
  - `meta` object — Optional pagination, feature flags, etc.

## Other responses

- `400` — Input Validation Error
- `401` — Unauthorized
- `404` — Not Found
- `409` — A verification already exists for this registration. Create a new sender registration to request a new code.
- `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)