---
title: "Rent a phone number from the telephony inventory"
method: POST
path: "/product/rent-number"
tags: ["Phone Numbers"]
---

# Rent a phone number from the telephony inventory

`POST /product/rent-number`

Rents an available number returned by [`GET /product/get-available-numbers`](#operation/searchAvailablePhoneNumbers). Charges the organization the prorated amount returned by [`GET /product/proration-amount`](#operation/getProrationAmount) immediately, then the monthly rate on each billing cycle.

Always call `GET /product/proration-amount` first to surface the immediate charge to your customer. The endpoint may return `200` with a body containing `requiresAction: true` when payment requires customer interaction (3-D Secure, etc.) — handle that branch in your client.

Released later via [`POST /product/release-number`](#operation/releasePhoneNumber).

## Request body

- object
  - `phoneNumber` string, required — The number to rent — exactly as returned by `GET /product/get-available-numbers` (no leading `+`).
  - `provider` 'plivo' | 'twilio', required

## Response `200`

Rental processed. Inspect `data.requiresAction` to determine whether the customer needs to complete a payment-method action.

- object
  - `status` boolean
  - `data` object
    - `requiresAction` boolean — If `true`, payment requires further customer action (3-D Secure / SCA). Surface the client-secret flow.

## Other responses

- `400` — Invalid input
- `401` — Unauthorized access
- `500` — Internal server error

---

[API](https://skmtc.net/smallest-inc/apis/agent-management-api.md) · [All operations](https://skmtc.net/smallest-inc/apis/agent-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smallest-inc/agent-management-api/revisions/9fd13f607823/schema)