---
title: "Add Dedicated Virtual Number"
method: POST
path: "/lease-number.json"
tags: ["Numbers"]
---

# Add Dedicated Virtual Number

`POST /lease-number.json`

Lease Number

Dedicated virtual numbers are used to receive MO (Mobile Originated) messages. They also make sure that all of your messages are sent from a number that is always the same. Dedicated Virtual Number availability is limited to certain countries. Check [Global Sender ID Information](https://portal.transmitsms.com/s/article/Global-Sender-ID-Information) for availability for your destination coutry.

## Response `200`

Successful response

- object
  - `number` string — Number assigned to your account
  - `price` number — Monthly cost of number leased in account currency
  - `next_charge` string, date — Date of next monthly charge. In ISO8601 format (YYYY-MM-DD).
  - `auto_renew` boolean — Returns auto_renew status of number. Always returns true for new number.

---

[API](https://skmtc.net/kudosity/apis/transmit-sms-api.md) · [All operations](https://skmtc.net/kudosity/apis/transmit-sms-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kudosity/transmit-sms-api/revisions/9f6c34b849af/schema)
