---
title: "Buy Phone Number"
method: POST
path: "/api/v1/phone-numbers/buy/"
tags: ["PhoneService"]
---

# Buy Phone Number

`POST /api/v1/phone-numbers/buy/`

## Request body

- BuyPhoneNumberRequest
  - `phone_number` string — Phone number to purchase (E.164 format)
  - `price` number, double — Purchase price
  - `per_minute_price_inbound` integer — Per-minute inbound call price
  - `per_minute_price_outbound` integer — Per-minute outbound call price

## Response `200`

Successful response

- BuyPhoneNumberResponse
  - `success` boolean
  - `message` string
  - `data` PurchasedPhoneNumber
    - `phone_number` string — The purchased phone number
    - `price` number, double — Price paid
    - `status` string — Purchase status
    - `purchased_at` string — Timestamp of purchase

---

[API](https://skmtc.net/ravan/apis/agni-api.md) · [All operations](https://skmtc.net/ravan/apis/agni-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ravan/agni-api/revisions/48f45dc58534/schema)