---
title: "Purchase a per-service number"
method: POST
path: "/per-service/purchase"
tags: ["Per-Service Numbers"]
---

# Purchase a per-service number

`POST /per-service/purchase`

## Request

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

Purchase a dedicated phone number for receiving SMS from a specific service (e.g. WhatsApp, Telegram). The number is exclusively assigned to you for the chosen service and duration. Cost is deducted from your account balance.

## Request body

- object
  - `locale` string, required: Country code (e.g. US, UK, AU)
  - `service` string, required: Service slug from the /per-service/services endpoint
  - `duration` 'oneWeek' | 'oneMonth' | 'sixMonths' | 'twelveMonths', required

## Response `200`

Successfully purchased per-service number

- object
  - `success` boolean
  - `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=...
  - `rental` object
    - `rentId` string: Unique rental identifier (used for renewals and message retrieval)
    - `phoneNumber` string
    - `service` string
    - `serviceName` string
    - `locale` string
    - `rentalStartDate` number
    - `rentalEndDate` number
    - `price` string

## Other responses

- `400`: Invalid request, service not found, insufficient balance, or no availability
- `401`: Unauthorized - Invalid API key

---

[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)