Senders

Request a verification code

Changed on

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.
post/v2/senders/registrations/{registration_id}/verifications

Request

  • Base URL
    https://api.transmitmessage.com
  • Auth
    API key in header x-api-key

Path parameters

registration_idstring uuid required

Unique identifier for the sender registration.

Request body

method'SMS' required

Method used to deliver the verification code.

originating_senderstring required

Verified sender owned by the account that the API uses to send the verification code.

Response

Successful response containing the verification details.

requestobject

Optional metadata (e.g. requestId, traceId)

metaobject

Optional pagination, feature flags, etc.

Changes

    • breaking

      the response's body type changed from no type to object for status

    • info

      removed subschema #2 from the response body allOf list for the response status

    • info

      added the non-success response with the status

    • info

      added the required property to the response with the status