---
title: "Purchase numbers"
method: POST
path: "/orders/numbers"
tags: ["orders"]
---

# Purchase numbers

`POST /orders/numbers`

Purchase numbers. There are many ways to purchase a number. Set either 'tollFreeCount' or 'localCount' along with some querying fields to purchase numbers by bulk query. Set the list of numbers to purchase by list. Available numbers will be purchased using CallFire credits owned by the user. Make sure the account has enough credits before trying to purchase

## Query parameters

- `fields` string

## Request body

- NumberPurchaseRequest — Request object is used to order a local or toll-free numbers
  - `authorizePaymentOnly` boolean — ~
  - `tollFreeCount` integer — Total count of toll-free numbers requested
  - `localCount` integer — Total count of local numbers requested
  - `prefix` string — Country prefix of requested numbers
  - `city` string — City of requested numbers
  - `state` string — A two-letter state code of requested numbers
  - `zipcode` string — A five-digit Zip code of requested numbers
  - `numbers` string[] — A list of phone numbers in E.164 format (11-digit) to buy. Example: 12132000384
  - `promo` string — ~

## Response `201`

successful operation

- ResourceId — An id of a resource
  - `id` integer — An id of a resource

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `500` — Internal Server Error

---

[API](https://skmtc.dev/callfire/apis/callfire-api-documentation.md) · [All operations](https://skmtc.dev/callfire/apis/callfire-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/callfire/callfire-api-documentation/revisions/9f6fb501bc03/schema)