Public API v1

Numbers API

List activation countries and services, purchase wallet-backed phone numbers, poll for SMS codes, and cancel eligible orders through the Xclusive Plugs API.

Start integrating View Markdown
POST https://www.xclusiveplugs.com/api/v1/numbers/orders 
{
  "country_id": 1,
  "service_id": 123,
  "idempotency_key": "number-order-20260501-0001"
}

Documentation Hub

API Collections

Shared documentation system for every public API collection.
Available Logs API Browse categories, buy logs, and review orders. Available Numbers API Phone number catalog, purchase, and activation workflows. Available Boosting API Social boosting products, checkout, and order tracking. Available Tools API Developer tooling products and delivery endpoints.

Base URL

Production Endpoint

All paths in this guide are relative to the current API base URL. Protected endpoints require bearer authentication.

https://www.xclusiveplugs.com/api/v1

Security

Authentication

Bearer API Key

Generate your API key from API Access. Copy it immediately; it is displayed only once. Generating a new key revokes the previous key.

Required headers 
Accept: application/json
Authorization: Bearer YOUR_API_KEY_HERE
401 Response
{
  "success": false,
  "status": 401,
  "message": "Unauthenticated. Please provide a valid bearer token.",
  "code": "UNAUTHENTICATED"
}
GET

Wallet Balance

/wallet

Returns the authenticated user's wallet balance. Requires bearer authentication.

Request Examples 
curl -X GET "https://www.xclusiveplugs.com/api/v1/wallet" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE"
const response = await fetch('https://www.xclusiveplugs.com/api/v1/wallet', {
  method: 'GET',
  headers: {
    'Accept': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY_HERE'
  }
});
const data = await response.json();
console.log(data);
import requests

url = 'https://www.xclusiveplugs.com/api/v1/wallet'
headers = {
    'Accept': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY_HERE'
}

response = requests.get(url, headers=headers)
print(response.json())
<?php

$ch = curl_init();

$headers = [
    'Accept: application/json',
    'Authorization: Bearer YOUR_API_KEY_HERE'
];

curl_setopt_array($ch, [
    CURLOPT_URL => 'https://www.xclusiveplugs.com/api/v1/wallet',
    CURLOPT_HTTPHEADER => $headers,
    CURLOPT_RETURNTRANSFER => true,
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
print_r($data);
curl_close($ch);
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://www.xclusiveplugs.com/api/v1/wallet"))
    .header("Accept", "application/json")
    .header("Authorization", "Bearer YOUR_API_KEY_HERE")
    .GET()
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
200 Response
{
  "success": true,
  "data": {
    "balance": "12500.00",
    "currency": "NGN"
  }
}

Production Flow

Xclusive Plugs Number Checkout

Your integration sends only the country, service, optional area code preference, and idempotency key. Xclusive Plugs calculates the final NGN price, validates wallet balance, reserves the number, stores the order, and returns a stable JSON response.

Live catalog Wallet-backed Idempotent checkout Code polling
GET

List Countries

/numbers/countries

Returns cached countries available for number activations. Requires bearer authentication.

Request Examples 
curl -X GET "https://www.xclusiveplugs.com/api/v1/numbers/countries" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE"
const response = await fetch('https://www.xclusiveplugs.com/api/v1/numbers/countries', {
  method: 'GET',
  headers: {
    'Accept': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY_HERE'
  }
});
const data = await response.json();
console.log(data);
import requests

url = 'https://www.xclusiveplugs.com/api/v1/numbers/countries'
headers = {
    'Accept': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY_HERE'
}

response = requests.get(url, headers=headers)
print(response.json())
<?php

$ch = curl_init();

$headers = [
    'Accept: application/json',
    'Authorization: Bearer YOUR_API_KEY_HERE'
];

curl_setopt_array($ch, [
    CURLOPT_URL => 'https://www.xclusiveplugs.com/api/v1/numbers/countries',
    CURLOPT_HTTPHEADER => $headers,
    CURLOPT_RETURNTRANSFER => true,
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
print_r($data);
curl_close($ch);
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://www.xclusiveplugs.com/api/v1/numbers/countries"))
    .header("Accept", "application/json")
    .header("Authorization", "Bearer YOUR_API_KEY_HERE")
    .GET()
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
200 Response
{
  "success": true,
  "data": [
    {
      "id": "1",
      "name": "United States",
      "short": "us",
      "calling_code": "1",
      "region": "North America",
      "image": "https://flagcdn.com/20x15/us.png"
    }
  ]
}
GET

List Number Services

/numbers/services

Fetches available activation services for a country, including final wallet prices, current availability, and recent delivery success rate. Requires bearer authentication.

Query Type Description
country_id integer Required. Country ID from the countries endpoint.
Request Examples 
curl -X GET "https://www.xclusiveplugs.com/api/v1/numbers/services?country_id=1" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE"
const response = await fetch('https://www.xclusiveplugs.com/api/v1/numbers/services?country_id=1', {
  method: 'GET',
  headers: {
    'Accept': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY_HERE'
  }
});
const data = await response.json();
console.log(data);
import requests

url = 'https://www.xclusiveplugs.com/api/v1/numbers/services?country_id=1'
headers = {
    'Accept': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY_HERE'
}

response = requests.get(url, headers=headers)
print(response.json())
<?php

$ch = curl_init();

$headers = [
    'Accept: application/json',
    'Authorization: Bearer YOUR_API_KEY_HERE'
];

curl_setopt_array($ch, [
    CURLOPT_URL => 'https://www.xclusiveplugs.com/api/v1/numbers/services?country_id=1',
    CURLOPT_HTTPHEADER => $headers,
    CURLOPT_RETURNTRANSFER => true,
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
print_r($data);
curl_close($ch);
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://www.xclusiveplugs.com/api/v1/numbers/services?country_id=1"))
    .header("Accept", "application/json")
    .header("Authorization", "Bearer YOUR_API_KEY_HERE")
    .GET()
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
200 Response
{
  "success": true,
  "data": [
    {
      "service_id": "123",
      "service_name": "Telegram",
      "country_id": "1",
      "country_name": "United States",
      "price": "850.00",
      "currency": "NGN",
      "available_quantity": 24,
      "success_rate": 92,
      "category": "Activation"
    }
  ]
}
GET

List Area Codes

/numbers/area-codes

Returns optional area codes for services that support area filtering. If no specific area codes are available, the API returns Random so your integration can purchase any available number. Requires bearer authentication.

Query Type Description
country_id integer Required. Country ID.
service_id integer Required. Service ID.
Request Examples 
curl -X GET "https://www.xclusiveplugs.com/api/v1/numbers/area-codes?country_id=1&service_id=123" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE"
const response = await fetch('https://www.xclusiveplugs.com/api/v1/numbers/area-codes?country_id=1&service_id=123', {
  method: 'GET',
  headers: {
    'Accept': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY_HERE'
  }
});
const data = await response.json();
console.log(data);
import requests

url = 'https://www.xclusiveplugs.com/api/v1/numbers/area-codes?country_id=1&service_id=123'
headers = {
    'Accept': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY_HERE'
}

response = requests.get(url, headers=headers)
print(response.json())
<?php

$ch = curl_init();

$headers = [
    'Accept: application/json',
    'Authorization: Bearer YOUR_API_KEY_HERE'
];

curl_setopt_array($ch, [
    CURLOPT_URL => 'https://www.xclusiveplugs.com/api/v1/numbers/area-codes?country_id=1&service_id=123',
    CURLOPT_HTTPHEADER => $headers,
    CURLOPT_RETURNTRANSFER => true,
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
print_r($data);
curl_close($ch);
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://www.xclusiveplugs.com/api/v1/numbers/area-codes?country_id=1&service_id=123"))
    .header("Accept", "application/json")
    .header("Authorization", "Bearer YOUR_API_KEY_HERE")
    .GET()
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
200 Response
{
  "success": true,
  "data": {
    "codes": ["Random"]
  }
}
POST

Purchase Number

/numbers/orders

Purchases one phone number for the selected country and service. Requires bearer authentication.

Do not send prices from your integration. Xclusive Plugs calculates the charge from the current service price and deducts the authenticated wallet. Use a unique idempotency_key for every checkout attempt.
Body Type Description
country_id integer Required. Country ID from the countries endpoint.
service_id integer Required. Service ID from the services endpoint.
selected_area_codes array Optional. Area code strings to include.
idempotency_key string Required. Unique key for this checkout attempt.
Request Examples 
curl -X POST "https://www.xclusiveplugs.com/api/v1/numbers/orders" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"country_id":1,"service_id":123,"selected_area_codes":["917"],"idempotency_key":"number-order-20260501-0001"}'
const response = await fetch('https://www.xclusiveplugs.com/api/v1/numbers/orders', {
  method: 'POST',
  headers: {
    'Accept': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY_HERE',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "country_id": 1,
    "service_id": 123,
    "selected_area_codes": [
        "917"
    ],
    "idempotency_key": "number-order-20260501-0001"
})
});
const data = await response.json();
console.log(data);
import requests

url = 'https://www.xclusiveplugs.com/api/v1/numbers/orders'
headers = {
    'Accept': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY_HERE',
    'Content-Type': 'application/json'
}
payload = {
    "country_id": 1,
    "service_id": 123,
    "selected_area_codes": [
        "917"
    ],
    "idempotency_key": "number-order-20260501-0001"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())
<?php

$ch = curl_init();

$headers = [
    'Accept: application/json',
    'Authorization: Bearer YOUR_API_KEY_HERE',
    'Content-Type: application/json'
];

curl_setopt_array($ch, [
    CURLOPT_URL => 'https://www.xclusiveplugs.com/api/v1/numbers/orders',
    CURLOPT_HTTPHEADER => $headers,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_POSTFIELDS => '{"country_id":1,"service_id":123,"selected_area_codes":["917"],"idempotency_key":"number-order-20260501-0001"}',
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
print_r($data);
curl_close($ch);
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
String payload = """
{
    "country_id": 1,
    "service_id": 123,
    "selected_area_codes": [
        "917"
    ],
    "idempotency_key": "number-order-20260501-0001"
}
""";

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://www.xclusiveplugs.com/api/v1/numbers/orders"))
    .header("Accept", "application/json")
    .header("Authorization", "Bearer YOUR_API_KEY_HERE")
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString(payload))
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
201 Response
{
  "success": true,
  "data": {
    "order_id": "123456789",
    "status": "waiting_for_code",
    "number": "+1234567890",
    "service_id": "123",
    "service_name": "Telegram",
    "country_id": "1",
    "country_name": "United States",
    "price": "850.00",
    "currency": "NGN",
    "time_left": 1200,
    "balance_after": "9150.00"
  }
}
GET

List Number Orders

/numbers/orders

Returns the authenticated user's number activation order history. Requires bearer authentication.

Request Examples 
curl -X GET "https://www.xclusiveplugs.com/api/v1/numbers/orders" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE"
const response = await fetch('https://www.xclusiveplugs.com/api/v1/numbers/orders', {
  method: 'GET',
  headers: {
    'Accept': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY_HERE'
  }
});
const data = await response.json();
console.log(data);
import requests

url = 'https://www.xclusiveplugs.com/api/v1/numbers/orders'
headers = {
    'Accept': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY_HERE'
}

response = requests.get(url, headers=headers)
print(response.json())
<?php

$ch = curl_init();

$headers = [
    'Accept: application/json',
    'Authorization: Bearer YOUR_API_KEY_HERE'
];

curl_setopt_array($ch, [
    CURLOPT_URL => 'https://www.xclusiveplugs.com/api/v1/numbers/orders',
    CURLOPT_HTTPHEADER => $headers,
    CURLOPT_RETURNTRANSFER => true,
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
print_r($data);
curl_close($ch);
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://www.xclusiveplugs.com/api/v1/numbers/orders"))
    .header("Accept", "application/json")
    .header("Authorization", "Bearer YOUR_API_KEY_HERE")
    .GET()
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
200 Response
{
  "success": true,
  "data": [
    {
      "order_id": "123456789",
      "status": "waiting_for_code",
      "number": "+1234567890",
      "service_name": "Telegram",
      "country_name": "United States",
      "price": "850.00",
      "currency": "NGN",
      "code": null,
      "refunded": false
    }
  ]
}
GET

Get Number Order

/numbers/orders/{order_id}

Retrieves the stored details of a single number order owned by the authenticated account. Use this endpoint for order lookups, audit views, and displaying the most recently saved status without running a live code check.

Request Examples 
curl -X GET "https://www.xclusiveplugs.com/api/v1/numbers/orders/123456789" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE"
const response = await fetch('https://www.xclusiveplugs.com/api/v1/numbers/orders/123456789', {
  method: 'GET',
  headers: {
    'Accept': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY_HERE'
  }
});
const data = await response.json();
console.log(data);
import requests

url = 'https://www.xclusiveplugs.com/api/v1/numbers/orders/123456789'
headers = {
    'Accept': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY_HERE'
}

response = requests.get(url, headers=headers)
print(response.json())
<?php

$ch = curl_init();

$headers = [
    'Accept: application/json',
    'Authorization: Bearer YOUR_API_KEY_HERE'
];

curl_setopt_array($ch, [
    CURLOPT_URL => 'https://www.xclusiveplugs.com/api/v1/numbers/orders/123456789',
    CURLOPT_HTTPHEADER => $headers,
    CURLOPT_RETURNTRANSFER => true,
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
print_r($data);
curl_close($ch);
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://www.xclusiveplugs.com/api/v1/numbers/orders/123456789"))
    .header("Accept", "application/json")
    .header("Authorization", "Bearer YOUR_API_KEY_HERE")
    .GET()
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
200 Response
{
  "success": true,
  "data": {
    "order_id": "123456789",
    "status": "waiting_for_code",
    "number": "+1234567890",
    "service_id": "123",
    "service_name": "Telegram",
    "country_id": "1",
    "country_name": "United States",
    "price": "850.00",
    "currency": "NGN",
    "code": null,
    "message": "Still waiting...",
    "time_left": 1200,
    "refunded": false,
    "created_at": "2026-05-01T12:00:00.000000Z"
  }
}
POST

Check Number Code

/numbers/orders/{order_id}/check

Runs a live code check for the number order and returns the latest status. In production, poll this endpoint every 5-10 seconds after purchase until code contains the received SMS verification code.

Request Examples 
curl -X POST "https://www.xclusiveplugs.com/api/v1/numbers/orders/123456789/check" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE"
const response = await fetch('https://www.xclusiveplugs.com/api/v1/numbers/orders/123456789/check', {
  method: 'POST',
  headers: {
    'Accept': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY_HERE'
  }
});
const data = await response.json();
console.log(data);
import requests

url = 'https://www.xclusiveplugs.com/api/v1/numbers/orders/123456789/check'
headers = {
    'Accept': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY_HERE'
}

response = requests.post(url, headers=headers)
print(response.json())
<?php

$ch = curl_init();

$headers = [
    'Accept: application/json',
    'Authorization: Bearer YOUR_API_KEY_HERE'
];

curl_setopt_array($ch, [
    CURLOPT_URL => 'https://www.xclusiveplugs.com/api/v1/numbers/orders/123456789/check',
    CURLOPT_HTTPHEADER => $headers,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
print_r($data);
curl_close($ch);
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://www.xclusiveplugs.com/api/v1/numbers/orders/123456789/check"))
    .header("Accept", "application/json")
    .header("Authorization", "Bearer YOUR_API_KEY_HERE")
    .method("POST", HttpRequest.BodyPublishers.noBody())
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
200 Response
{
  "success": true,
  "data": {
    "order_id": "123456789",
    "status": "completed",
    "number": "+1234567890",
    "service_id": "123",
    "service_name": "Telegram",
    "country_id": "1",
    "country_name": "United States",
    "price": "850.00",
    "currency": "NGN",
    "code": "12345",
    "message": "Code Received",
    "time_left": 875,
    "refunded": false,
    "created_at": "2026-05-01T12:00:00.000000Z"
  }
}
POST

Cancel Number

/numbers/orders/{order_id}/cancel

Cancels and refunds an eligible number order when no SMS code has been received.

Request Examples 
curl -X POST "https://www.xclusiveplugs.com/api/v1/numbers/orders/123456789/cancel" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE"
const response = await fetch('https://www.xclusiveplugs.com/api/v1/numbers/orders/123456789/cancel', {
  method: 'POST',
  headers: {
    'Accept': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY_HERE'
  }
});
const data = await response.json();
console.log(data);
import requests

url = 'https://www.xclusiveplugs.com/api/v1/numbers/orders/123456789/cancel'
headers = {
    'Accept': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY_HERE'
}

response = requests.post(url, headers=headers)
print(response.json())
<?php

$ch = curl_init();

$headers = [
    'Accept: application/json',
    'Authorization: Bearer YOUR_API_KEY_HERE'
];

curl_setopt_array($ch, [
    CURLOPT_URL => 'https://www.xclusiveplugs.com/api/v1/numbers/orders/123456789/cancel',
    CURLOPT_HTTPHEADER => $headers,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
print_r($data);
curl_close($ch);
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://www.xclusiveplugs.com/api/v1/numbers/orders/123456789/cancel"))
    .header("Accept", "application/json")
    .header("Authorization", "Bearer YOUR_API_KEY_HERE")
    .method("POST", HttpRequest.BodyPublishers.noBody())
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
200 Response
{
  "success": true,
  "data": {
    "order_id": "123456789",
    "status": "refunded",
    "number": "+1234567890",
    "code": null,
    "message": "Order cancelled and refunded",
    "refunded": true
  }
}

Reference

Error Responses

JSON
Error Format
{
  "success": false,
  "status": 422,
  "message": "No number is available for this service right now.",
  "code": "NUMBER_OUT_OF_STOCK"
}
USER_DISABLEDThe buyer account is disabled.
USER_BANNEDThe buyer account is banned.
UNAUTHENTICATEDThe bearer token is missing, invalid, or revoked.
VALIDATION_FAILEDOne or more request fields are missing or invalid.
INSUFFICIENT_BALANCEThe wallet balance cannot cover the purchase.
NUMBER_SERVICE_NOT_FOUNDThe selected number service does not exist for the selected country.
NUMBER_ORDER_NOT_FOUNDThe requested number order does not exist for the authenticated account.
NUMBER_OUT_OF_STOCKNo phone number is available for the selected service right now.
NUMBER_PRICE_CHANGEDThe number service price changed. Fetch services again before retrying.
NUMBER_CODE_ALREADY_RECEIVEDThe number already received a code and cannot be cancelled.
NUMBER_REFUND_FAILEDThe number was cancelled, but local refund completion needs support review.
IDEMPOTENCY_KEY_REUSEDThe idempotency key was used for a different request.