---
title: "Reserve a number for to a client private available numbers"
method: POST
path: "/number/reserve"
tags: ["number"]
---

# Reserve a number for to a client private available numbers

`POST /number/reserve`

Reserves phone numbers from carrier inventory into your private pool. Reserved numbers become exclusively available to your organization and can be provisioned to call flows. Use after searching carrier inventory to secure desired numbers.

## Request body

- NumberResponse[]
  - `number_id` integer — The unique identifier for the phone number record
  - `number` integer, required — The full actual phone number
  - `source` integer, required — Indicator that identifies which source where the number is located

## Response `200`

Reservation confirmation with status for each requested number

- StandardPostResponse[]
  - `result` string, required — Outcome of the request. String, typically 'success' or 'error'.
  - `data` string, required — Response payload. Shape varies by endpoint.
  - `entry_count` integer, required — The sequential number of the entry in the submitted array. Type: integer (int32).

## Other responses

- `default` — Unexpected error

---

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