Submit OTP

Complete a pending caller ID verification by submitting the OTP that was delivered via voice or SMS. On success the entry flips from pending to verified and is immediately usable as the from field on outbound calls.

Endpoint

POST https://api.tryvox.io/v1/voice/accounts/{auth_id}/verified-caller-ids/{phone_number}/verify

{phone_number} must be the E.164-formatted number you previously initiated verification for.

Request body

Parameter	Type	Required	Description
`otp`	string	yes	The 6-digit code TryVox delivered to the number.

Example request

curl -X POST https://api.tryvox.io/v1/voice/accounts/$TRYVOX_AUTH_ID/verified-caller-ids/+919876543210/verify \
  -u $TRYVOX_AUTH_ID:$TRYVOX_AUTH_TOKEN \
  -H "Content-Type: application/json" \
  -d '{"otp": "123456"}'

Response

200 OK:

{
  "id": "8f7a4b2e-91c2-4f3d-9a1e-2c4b6d8f0a1c",
  "account_id": "TJab12cd34",
  "phone_number": "+919876543210",
  "alias": "Office line",
  "verification_status": "verified",
  "verified_at": "2026-04-09T10:35:12Z",
  "created_at": "2026-04-09T10:30:00Z"
}

The number can now be used as from on outbound calls. The verification doesn't expire — it persists until you delete the entry or rotate to a new API key.

Errors

Status	Code	Reason
400	`VALIDATION_FAILED`	`otp` missing or empty
401	`INVALID_CREDENTIALS`	Auth ID / Auth Token bad
403	`FORBIDDEN`	Auth ID in URL doesn't match the authenticated key
404	`CALLER_ID_NOT_FOUND`	No pending verification exists for this `phone_number` on this account. Call Initiate first.
409	`ALREADY_VERIFIED`	Number is already verified — no OTP submission needed.
422	`INVALID_OTP`	OTP didn't match. Re-initiate to get a fresh code.

Notes

No retry counter on the OTP itself. A wrong OTP returns 422 but doesn't lock the entry — you can retry, or re-initiate to get a fresh code.
Stable phone-number key. The phone number (E.164) is the addressable key for all manage operations. Don't lose it; the id field is informational.

Next steps

Make an outbound call using this number as from
List your verified caller IDs
Manage caller IDs

Submit OTP

On this page