---
title: "Purchase phone numbers"
method: POST
path: "/purchase"
tags: ["Phone Numbers (Unlimited)"]
---

# Purchase phone numbers

`POST /purchase`

## Request

- Base URL: `https://api.quackr.io`
- URL: `https://api.quackr.io/purchase`
- Auth: API key in header `x-api-key`

Purchase one or more phone numbers for a specified duration and locale.  Only certain locales support bulk quantities - please contact support if you need more info. The response includes the order number (orderId), which GET /orders can look up.

## Request body

- object
  - `duration` 'halfDay' | 'oneDay' | 'oneWeek' | 'oneMonth' | 'sixMonths' | 'twelveMonths', required
  - `locale` string, required
  - `quantity` integer
  - `carrier` 'US1' | 'US2': (US locale only) Select a specific carrier.
  - `receiveCalls` boolean: (US locale only) Enable the number to receive voice calls. Incoming calls will be transcribed and delivered as SMS messages to your stored messages.
  - `autoRenew` boolean: Automatically renew the number before it expires, using the same duration.

## Response `200`

Successfully purchased phone numbers

- object
  - `phoneNumbers` object[]
    - `id` integer
    - `number` string
  - `duration` string, nullable
  - `price` string
  - `locale` string
  - `orderId` string: This order's number. Every purchase and renewal gets one, always in this format: QK- and 8 letters and digits. Quote it to support, and look the order up with GET /orders?orderId=...
  - `success` boolean

## Other responses

- `400`: Invalid request parameters

---

[API](https://skmtc.dev/quackr/apis/quackr-api.md) · [All operations](https://skmtc.dev/quackr/apis/quackr-api/llms.txt) · [OpenAPI document](https://skmtc.dev/quackr/apis/quackr-api/revisions/9b7240306750?raw)