---
title: "Reserve FoneNumbers"
method: POST
path: "/fonenumbers/reserve"
tags: ["FoneNumbers", "fonenumbers"]
---

# Reserve FoneNumbers

`POST /fonenumbers/reserve`

## Request

- Base URL: `https://api.fonestorm.com/v2`
- URL: `https://api.fonestorm.com/v2/fonenumbers/reserve`
- Auth: API key in header `token`

Reserve FoneNumbers available in FracTEL inventory.

## Request body

- object
  - `order_string` string, required: Array of Valid order strings (Maximum 20)

## Response `200`

Success

- object
  - `fonenumber` FoneNumberReserve
    - `fonenumber` string: FoneNumber
    - `state` string: State
    - `rate_center` string: Rate Center
    - `expires_at` string: FoneNumber expires at
    - `result` string: Result of the order

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `default`: Error

---

[API](https://skmtc.dev/fonestorm/apis/fractel-api-2-12-87c-hail.md) · [All operations](https://skmtc.dev/fonestorm/apis/fractel-api-2-12-87c-hail/llms.txt) · [OpenAPI document](https://skmtc.dev/fonestorm/apis/fractel-api-2-12-87c-hail/revisions/9738d9b806d4?raw)