---
title: "POST /api/numbers/own"
method: POST
path: "/api/numbers/own"
---

# POST /api/numbers/own

`POST /api/numbers/own`

## Request

- Base URL: `https://call4.me`
- URL: `https://call4.me/api/numbers/own`
- Auth: HTTP bearer

Send a verification code to the user's own phone number: a text, or a call that reads the code out. Submit the code with POST /api/numbers/own/{number}/verify. At most 5 codes a day.

## Request body

- object
  - `number` string, required: the user's own phone number, e.g. "+14155550123" or "(415) 555-0123"
  - `method` 'sms' | 'call', required: how to send the code: a text, or a call that reads it out (for landlines)
  - `extension` string: keys the verification call dials once answered, to get past a phone menu to an extension; w waits half a second, W one second. method "call" only

## Response `202`

The code was sent; the number waits on it

- object
  - `number` string, required: formatted for people
  - `e164` string, required
  - `country` string, required: ISO 3166-1 alpha-2
  - `country_name` string, required
  - `status` 'pending' | 'verified', required: pending: the code was sent and has not come back yet
  - `method` 'sms' | 'call', required: how the code was sent
  - `verified_at` string, nullable, required

## Other responses

- `400`: Request failed
- `401`: Request failed
- `409`: Request failed
- `429`: Request failed
- `502`: Request failed

---

[API](https://skmtc.dev/call4/apis/call4me-api.md) · [All operations](https://skmtc.dev/call4/apis/call4me-api/llms.txt) · [OpenAPI document](https://skmtc.dev/call4/apis/call4me-api/revisions/f4fa1a5c5f9b?raw)