---
title: "Send Verification"
method: POST
path: "/v1/verify/send"
tags: ["verification"]
---

# Send Verification

`POST /v1/verify/send`

Send a 6-digit verification code to a phone number via SMS.

Use this instead of sending your own code over `POST /v1/messages`: it
routes through carrier-registered sender IDs, so it reaches countries
where plain application SMS from a US long code is not deliverable
(e.g. Greece, UAE, the Philippines, the UK).

The code is always 6 digits, expires after 10 minutes, and allows up to
3 check attempts. None of these are configurable.

**Billing.** Sending a code costs the standard outbound SMS rate for the
destination country. A successful `POST /v1/verify/check` adds a $0.05
verification fee; failed, expired, and exhausted checks are not charged.

**Destination coverage.** A small number of countries are unavailable and
return 400. Email founders@agentphone.to if you need access to one.

## Request body

- SendVerificationRequest
  - `phone_number` string, required — Phone number in E.164 format (e.g. +639277372243)

## Response `200`

Successful Response

- SendVerificationResponse
  - `verification_id` string, required — Pass this to POST /v1/verify/check along with the code the user entered.
  - `status` string, required — Verification status. `pending` until the code is checked.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/agentphone/apis/agentphone-api.md) · [All operations](https://skmtc.net/agentphone/apis/agentphone-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/agentphone/agentphone-api/versions/3f3aa65dcd20/schema)