---
title: "Transfer number"
method: POST
path: "/{api_key}/transfer-number"
tags: ["Transfers"]
---

# Transfer number

`POST /{api_key}/transfer-number`

Transfer number from one account to another.

## Path parameters

- `api_key` string, required

## Request body

- TransferNumberRequest
  - `country` string
  - `from` string
  - `number` number
  - `to` string

## Response `200`

Number transfer response

- TransferNumberResponse
  - `country` string — The two character country code in ISO 3166-1 alpha-2 format
  - `from` string — Account the number is transferred from
  - `number` string — Number transfered
  - `to` string — Account the number is transferred to

## Other responses

- `401` — Credential is missing or invalid
- `403` — Action is forbidden
- `404` — Action is forbidden
- `409` — Conflict
- `422` — Validation Error

---

[API](https://skmtc.net/vonage/apis/subaccounts.md) · [All operations](https://skmtc.net/vonage/apis/subaccounts/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vonage/subaccounts/versions/48b589cc0b41/schema)