Per-Service Numbers

Purchase a per-service number

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.

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

Request body

localestring required

Country code (e.g. US, UK, AU)

servicestring required

Service slug from the /per-service/services endpoint

duration'oneWeek' | 'oneMonth' | 'sixMonths' | 'twelveMonths' required

Example request

{
  "locale": "US",
  "service": "wa",
  "duration": "oneMonth"
}

Response

Successfully purchased per-service number

successboolean
orderIdstring

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=...

Example response

{
  "success": true,
  "orderId": "QK-7K3M9P2X",
  "rental": {
    "rentId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "phoneNumber": "12025551234",
    "service": "wa",
    "serviceName": "WhatsApp",
    "locale": "US",
    "rentalStartDate": 1709251200000,
    "rentalEndDate": 1711843200000,
    "price": "4.50"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.