---
title: "Rent a Number"
method: POST
path: "/numbers/my"
---

# Rent a Number

`POST /numbers/my`

Rent VLN or TOLL FREE Numbers for your applications. Each Number will have a delivery rate of 1 SMS/sec.

## Headers

- `Authorization` string, required
- `Content-Type` string, required

## Request body

- object
  - `msisdn` string, required — The phone number. Format with a '+' and country code e.g., +3069485xxxxx (E.164 format).
  - `inboundSmsCallbackUrl` string — Defines the callback URL that will receive the inbound messages.
  - `voiceInboundStrategy` object — Defines the Voice inbound strategy
    - `dialplanUrl` string — Defines the dialplan URL
    - `forwardCallToSip` string — A valid SIP address to forward the inbound call
    - `forwardCallTo` string — A valid phone number in E.164 Format to forward the inbound call
  - `inboundVoiceCallbackUrl` string — Defines the callback URL that will receive the inbound Voice messages.

## Response `200`

200

- object
  - `trackingId` string
  - `msisdn` string
  - `country` string
  - `services` string[]
  - `inboundCosts` object[]
    - `price` number
    - `currency` string
    - `service` string
  - `monthlyCosts` object
    - `price` number
    - `currency` string
  - `activationCosts` object
    - `price` number
    - `currency` string
  - `inboundSmsCallbackUrl` string
  - `nextRenewal` string
  - `chargeInterval` integer
  - `tollFree` boolean

## Other responses

- `400` — 400

---

[API](https://skmtc.net/routee/apis/auth.md) · [All operations](https://skmtc.net/routee/apis/auth/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/routee/auth/versions/5cef04e8f7d8/schema)