{"info":{"_postman_id":"50d0d309-24c7-48ad-88ad-d76f97ca787d","name":"Proxy-Hunks","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"description":"","owner":"25943953","collectionId":"50d0d309-24c7-48ad-88ad-d76f97ca787d","publishedId":"2sBXcGFLJn","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-02-26T14:18:49.000Z"},"item":[{"name":"Get up countries By Services","id":"ffa18774-03b9-4348-a2dc-b8364398be42","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://telegram.proxyhunks.xyz/api/v1/reseller/virtual-numbers/services?country=6","description":"

Purpose

Retrieve the list of available countries for virtual numbers for the reseller API, including per-country capabilities (e.g., retry support, rent availability, and multi-service availability).

Endpoint

Base URL: http://telegram.proxyhunks.xyz
\n
Path: /api/v1/reseller/virtual-numbers/countries
\n
Method: GET
\n
Full URL: http://telegram.proxyhunks.xyz/api/v1/reseller/virtual-numbers/countries
\n

Example Success Response (200)

{\n  \"status\": \"success\",\n  \"data\": {\n    \"countries\": [\n      {\n        \"id\": 0,\n        \"name\": \"Russia\",\n        \"retry\": true,\n        \"rent\": false,\n        \"multiService\": false\n      },\n      {\n        \"id\": 1,\n        \"name\": \"Ukraine\",\n        \"retry\": true,\n        \"rent\": false,\n        \"multiService\": false\n      },\n      {\n        \"id\": 2,\n        \"name\": \"Kazakhstan\",\n        \"retry\": true,\n        \"rent\": false,\n        \"multiService\": false\n      },\n      {\n        \"id\": 3,\n        \"name\": \"China\",\n        \"retry\": false,\n        \"rent\": false,\n        \"multiService\": false\n      },\n      {\n        \"id\": 4,\n        \"name\": \"Philippines\",\n        \"retry\": true,\n        \"rent\": false,\n        \"multiService\": false\n      },\n      {\n        \"id\": 5,\n        \"name\": \"Myanmar\",\n        \"retry\": true,\n        \"rent\": false,\n        \"multiService\": false\n      },\n      {\n        \"id\": 6,\n        \"name\": \"Indonesia\",\n        \"retry\": true,\n        \"rent\": false,\n        \"multiService\": false\n      },\n      {\n        \"id\": 7,\n        \"name\": \"Malaysia\",\n        \"retry\": true,\n        \"rent\": false,\n        \"multiService\": false\n      },\n      {\n        \"id\": 8,\n        \"name\": \"Kenya\",\n        \"retry\": true,\n        \"rent\": false,\n        \"multiService\": false\n      },\n      {\n        \"id\": 9,\n        \"name\": \"Tanzania\",\n        \"retry\": false,\n        \"rent\": false,\n        \"multiService\": false\n      }\n    ],\n    \"total\": 195\n  },\n  \"errors\": []\n}\n\n

Response Fields

status (string): Overall request status (e.g., success).
\n
data (object): Container for response payload.
\n
- data.countries (array of objects): List of supported countries.
  \n
  - id (number): Country identifier used by the API.
    \n
  - name (string): Country display name.
    \n
  - retry (boolean): Indicates whether retry is supported for this country.
    \n
  - rent (boolean): Indicates whether renting is supported for this country.
    \n
  - multiService (boolean): Indicates whether multi-service is supported for this country.
    \n
  \n
- data.total (number): Total number of countries available.
  \n
\n
errors (array): List of errors (empty array when the request succeeds).
\n

Usage Notes

This request is a read-only lookup and does not require a request body.
\n
Use the returned id values when calling other virtual-number endpoints that require a country identifier.
\n
Feature flags (retry, rent, multiService) may vary by country; rely on these fields to determine what operations are supported.
\n

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-API-Key"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"50d0d309-24c7-48ad-88ad-d76f97ca787d","id":"50d0d309-24c7-48ad-88ad-d76f97ca787d","name":"Proxy-Hunks","type":"collection"}},"urlObject":{"protocol":"http","path":["api","v1","reseller","virtual-numbers","services"],"host":["telegram","proxyhunks","xyz"],"query":[{"key":"country","value":"6"}],"variable":[]}},"response":[],"_postman_id":"ffa18774-03b9-4348-a2dc-b8364398be42"},{"name":"Get list of services","id":"2fecf8b8-c175-46e3-b7b0-c1f9b6e7da5f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://telegram.proxyhunks.xyz/api/v1/reseller/virtual-numbers/services?country=6","description":"

Purpose

Retrieve the list of available virtual-number services for a specific country.

Endpoint

GET /api/v1/reseller/virtual-numbers/services

Base URL (as currently configured in this request):
http://telegram.proxyhunks.xyz

Query params

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Param	Type	Required	Description
`country`	integer	Yes	Country identifier to filter available services.

Example request

GET http://telegram.proxyhunks.xyz/api/v1/reseller/virtual-numbers/services?country=6\n\n

Example 200 response (snippet)

{\"status\":\"success\",\"data\":{\"services\":[{\"code\":\"aab\",\"name\":\"BharatPe\"},{\"code\":\"aav\",\"name\":\"Alchemy \"},{\"code\":\"abd\",\"name\":\"BeBoo\"}],\"total\":308},\"errors\":[]}\n\n

Response fields

data.services[]: Array of services.
\n
- code: Service code.
  \n
- name: Human-readable service name.
  \n
\n
data.total: Total number of services available for the given country.
\n
errors: Array of error objects (empty on success).
\n

Notes

Pagination: This endpoint returns a total count, but no pagination parameters are defined in this request. If the API supports pagination (e.g., page, limit, offset), document and add them here.
\n
Total field: Use data.total to understand the full size of the service catalog for the selected country.
\n

Error handling (placeholders)

Document the API’s error format and status codes when available.

4xx (client errors): e.g., invalid/missing country.
\n
5xx (server errors): unexpected server failure.
\n

Suggested fields to capture when known:

HTTP status code
\n
Error message(s)
\n
Error code(s)
\n
errors[] object shape
\n

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-API-Key"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"50d0d309-24c7-48ad-88ad-d76f97ca787d","id":"50d0d309-24c7-48ad-88ad-d76f97ca787d","name":"Proxy-Hunks","type":"collection"}},"urlObject":{"protocol":"http","path":["api","v1","reseller","virtual-numbers","services"],"host":["telegram","proxyhunks","xyz"],"query":[{"key":"country","value":"6"}],"variable":[]}},"response":[],"_postman_id":"2fecf8b8-c175-46e3-b7b0-c1f9b6e7da5f"},{"name":"Get current prices","id":"275e9473-abfe-4a20-b996-57c0acd0b067","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://telegram.proxyhunks.xyz/api/v1/reseller/virtual-numbers/price?service=wa&country=6","description":"

Get current prices

Returns the current reseller price and availability for virtual numbers for a given service and country.

Endpoint

GET /api/v1/reseller/virtual-numbers/price

Query parameters

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Param	Required	Type	Description
`service`	Yes	string	Service code to price (example: `wa`).
`country`	Yes	number	Country ID (example: `6`).

\n
Note: Both query params are required for a successful lookup.
\n

Example request

GET http://telegram.proxyhunks.xyz/api/v1/reseller/virtual-numbers/price?service=wa&country=6\n\n

Example 200 response

{\"status\":\"success\",\"data\":{\"serviceCode\":\"wa\",\"countryId\":6,\"userPrice\":0.54,\"available\":3972,\"currency\":\"USD\"},\"errors\":[]}\n\n

Response fields

status (string): Request result status (e.g., success).
\n
data (object): Pricing payload.
\n
- serviceCode (string): Service code used for the quote.
  \n
- countryId (number): Country ID used for the quote.
  \n
- userPrice (number): Price per number for the reseller.
  \n
- available (number): Count of available numbers.
  \n
- currency (string): Currency code (e.g., USD).
  \n
\n
errors (array): Error details (empty on success).
\n

Errors & usage notes

If service or country is missing/invalid, expect a non-200 response with details in the errors array (format may vary).
\n
Use this endpoint before ordering/provisioning numbers to confirm current price and availability.
\n
available can change frequently; treat it as a point-in-time value.
\n

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-API-Key"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"50d0d309-24c7-48ad-88ad-d76f97ca787d","id":"50d0d309-24c7-48ad-88ad-d76f97ca787d","name":"Proxy-Hunks","type":"collection"}},"urlObject":{"protocol":"http","path":["api","v1","reseller","virtual-numbers","price"],"host":["telegram","proxyhunks","xyz"],"query":[{"key":"service","value":"wa"},{"key":"country","value":"6"}],"variable":[]}},"response":[],"_postman_id":"275e9473-abfe-4a20-b996-57c0acd0b067"},{"name":"Request a number","id":"67c9f79b-adaa-4d3c-977c-f40aed7f60c3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"service\": \"wa\",\n \"country\": 6\n}","options":{"raw":{"language":"json"}}},"url":"http://telegram.proxyhunks.xyz/api/v1/reseller/virtual-numbers/buy","description":"

Purpose

Buy (reserve) a virtual number for a given service and country for the reseller account.

Endpoint

POST http://telegram.proxyhunks.xyz/api/v1/reseller/virtual-numbers/buy

Authentication / Required headers

\n
Placeholder — confirm with API provider.
\n

Common patterns (use the one your API requires):

Authorization: Bearer {{token}}
\n
X-API-Key: {{api_key}}
\n

Also recommended:

Content-Type: application/json
\n
Accept: application/json
\n

Request body (JSON)

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Required	Allowed values / Notes
`service`	string	yes	Service code. Example: `\"wa\"` (likely WhatsApp). Use a valid service code supported by your account.
`country`	number (integer)	yes	Country identifier. Example: `6`. Use a valid country ID for the selected service.

Example request body

{\n  \"service\": \"wa\",\n  \"country\": 6\n}\n\n

Example request

curl --request POST \\\n  --url 'http://telegram.proxyhunks.xyz/api/v1/reseller/virtual-numbers/buy' \\\n  --header 'Content-Type: application/json' \\\n  --header 'Accept: application/json' \\\n  --header 'Authorization: Bearer {{token}}' \\\n  --data '{\"service\":\"wa\",\"country\":6}'\n\n

Responses

Success (example)

\n
Not observed in the last run. Shape may vary.
\n

Typical patterns:

200 OK or 201 Created

      {\n      \"status\": \"success\",\n      \"data\": {\n        \"id\": \"<number_id>\",\n        \"service\": \"wa\",\n        \"country\": 6,\n        \"number\": \"<phone_number>\"\n      },\n      \"errors\": null\n      }\n\n

Error — Insufficient funds (observed)

400 Bad Request

{\n  \"status\": \"error\",\n  \"data\": null,\n  \"errors\": [\n    {\n      \"message\": \"Insufficient funds. Required: $0.54, Ava...\",\n      \"code\": 400,\n      \"customData\": {\n        \"required\": 0.54,\n        \"available\": 0,\n        \"shortfall\": 0.54\n      }\n    }\n  ]\n}\n\n

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-API-Key"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"50d0d309-24c7-48ad-88ad-d76f97ca787d","id":"50d0d309-24c7-48ad-88ad-d76f97ca787d","name":"Proxy-Hunks","type":"collection"}},"urlObject":{"protocol":"http","path":["api","v1","reseller","virtual-numbers","buy"],"host":["telegram","proxyhunks","xyz"],"query":[],"variable":[]}},"response":[],"_postman_id":"67c9f79b-adaa-4d3c-977c-f40aed7f60c3"},{"name":"Get the Activation","id":"69a0637c-3ae0-47ec-9426-ba102e127c4f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://telegram.proxyhunks.xyz/api/v1/reseller/virtual-numbers/status/ 119715136\n","description":"

Purpose

Retrieve the current status/details of a virtual number activation for a reseller.

Endpoint

GET /api/v1/reseller/virtual-numbers/status/{activationId}

Base URL (as currently configured):
http://telegram.proxyhunks.xyz

Path parameter

activationId (required): The activation identifier returned when requesting/reserving a virtual number.

Notes

404 Not Found typically means the activation does not exist or does not belong to the authenticated reseller/account.

Usage example

Replace {activationId} with your activation id:

GET http://telegram.proxyhunks.xyz/api/v1/reseller/virtual-numbers/status/119715136\n\n

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-API-Key"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"50d0d309-24c7-48ad-88ad-d76f97ca787d","id":"50d0d309-24c7-48ad-88ad-d76f97ca787d","name":"Proxy-Hunks","type":"collection"}},"urlObject":{"protocol":"http","path":["api","v1","reseller","virtual-numbers","status"," 119715136\n"],"host":["telegram","proxyhunks","xyz"],"query":[],"variable":[]}},"response":[],"_postman_id":"69a0637c-3ae0-47ec-9426-ba102e127c4f"},{"name":"Get the Activation History","id":"73d2fb60-c38d-4daf-a064-12a13aa190a9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://telegram.proxyhunks.xyz/api/v1/reseller/virtual-numbers/history","description":"

Get the Activation History

Retrieves your virtual number activation history (e.g., WhatsApp/other services activations) including current status, pricing, timestamps, and any received verification code.

Authentication

This endpoint is expected to be authenticated.

Use the same auth mechanism configured for the rest of the Proxy-Hunks collection (commonly an API key / Bearer token).
\n
If you receive 401/403, verify your token/key and that it is being sent in the required header.
\n

Request

Method: GET

Path: /api/v1/reseller/virtual-numbers/history

Query parameters

Based on the response payload, pagination parameters are supported:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Param	Type	Description	Default/Notes
`limit`	number	Max activations returned per page	Response shows `limit: 50`
`offset`	number	Pagination offset	Response shows `offset: 0`

\n
If limit/offset are omitted, server defaults may apply.
\n

Response (200)

Returns a JSON object with:

status (string): e.g. \"success\"
\n
data (object):
\n
- activations (array): list of activation records
  \n
- total (number): total activation records available
  \n
- limit (number): page size applied
  \n
- offset (number): offset applied
  \n
\n
errors (array): error list (empty on success)
\n

Example success response (200)

{\n  \"status\": \"success\",\n  \"data\": {\n    \"activations\": [\n      {\n        \"activationId\": \"120888410\",\n        \"phoneNumber\": \"6283833304762\",\n        \"serviceCode\": \"wa\",\n        \"countryId\": 6,\n        \"price\": 0.54,\n        \"status\": \"active\",\n        \"code\": null,\n        \"verificationType\": null,\n        \"canGetAnotherSms\": false,\n        \"refunded\": false,\n        \"source\": \"api\",\n        \"createdAt\": \"2026-02-26T11:55:32.238Z\",\n        \"completedAt\": null,\n        \"cancelledAt\": null,\n        \"expiredAt\": null\n      },\n      {\n        \"activationId\": \"120817600\",\n        \"phoneNumber\": \"62882015423190\",\n        \"serviceCode\": \"wa\",\n        \"countryId\": 6,\n        \"price\": 0.54,\n        \"status\": \"cancelled\",\n        \"code\": null,\n        \"verificationType\": null,\n        \"canGetAnotherSms\": false,\n        \"refunded\": true,\n        \"source\": \"api\",\n        \"createdAt\": \"2026-02-26T11:19:22.034Z\",\n        \"completedAt\": null,\n        \"cancelledAt\": \"2026-02-26T11:21:50.134Z\",\n        \"expiredAt\": null\n      },\n      {\n        \"activationId\": \"119943917\",\n        \"phoneNumber\": \"6283873135346\",\n        \"serviceCode\": \"wa\",\n        \"countryId\": 6,\n        \"price\": 0.54,\n        \"status\": \"active\",\n        \"code\": null,\n        \"verificationType\": null,\n        \"canGetAnotherSms\": false,\n        \"refunded\": false,\n        \"source\": \"api\",\n        \"createdAt\": \"2026-02-26T03:35:05.066Z\",\n        \"completedAt\": null,\n        \"cancelledAt\": null,\n        \"expiredAt\": null\n      },\n      {\n        \"activationId\": \"119943343\",\n        \"phoneNumber\": \"6283133769440\",\n        \"serviceCode\": \"wa\",\n        \"countryId\": 6,\n        \"price\": 0.54,\n        \"status\": \"active\",\n        \"code\": null,\n        \"verificationType\": null,\n        \"canGetAnotherSms\": false,\n        \"refunded\": false,\n        \"source\": \"api\",\n        \"createdAt\": \"2026-02-26T03:34:43.802Z\",\n        \"completedAt\": null,\n        \"cancelledAt\": null,\n        \"expiredAt\": null\n      },\n      {\n        \"activationId\": \"119715136\",\n        \"phoneNumber\": \"6285187684632\",\n        \"serviceCode\": \"wa\",\n        \"countryId\": 6,\n        \"price\": 0.54,\n        \"status\": \"active\",\n        \"code\": null,\n        \"verificationType\": null,\n        \"canGetAnotherSms\": false,\n        \"refunded\": false,\n        \"source\": \"api\",\n        \"createdAt\": \"2026-02-26T01:30:03.371Z\",\n        \"completedAt\": null,\n        \"cancelledAt\": null,\n        \"expiredAt\": null\n      },\n      {\n        \"activationId\": \"118864807\",\n        \"phoneNumber\": \"61493358615\",\n        \"serviceCode\": \"auz\",\n        \"countryId\": 175,\n        \"price\": 1.36,\n        \"status\": \"cancelled\",\n        \"code\": null,\n        \"verificationType\": null,\n        \"canGetAnotherSms\": false,\n        \"refunded\": true,\n        \"source\": \"api\",\n        \"createdAt\": \"2026-02-25T17:33:37.511Z\",\n        \"completedAt\": null,\n        \"cancelledAt\": \"2026-02-25T17:36:48.113Z\",\n        \"expiredAt\": null\n      },\n      {\n        \"activationId\": \"112786009\",\n        \"phoneNumber\": \"2348146384942\",\n        \"serviceCode\": \"wa\",\n        \"countryId\": 19,\n        \"price\": 0.81,\n        \"status\": \"completed\",\n        \"code\": \"682595\",\n        \"verificationType\": \"sms\",\n        \"canGetAnotherSms\": false,\n        \"refunded\": false,\n        \"source\": \"api\",\n        \"createdAt\": \"2026-02-23T09:55:25.331Z\",\n        \"completedAt\": \"2026-02-23T09:56:26.361Z\",\n        \"cancelledAt\": null,\n        \"expiredAt\": null\n      },\n      {\n        \"activationId\": \"112782587\",\n        \"phoneNumber\": \"254776147988\",\n        \"serviceCode\": \"wa\",\n        \"countryId\": 8,\n        \"price\": 0.53,\n        \"status\": \"cancelled\",\n        \"code\": null,\n        \"verificationType\": null,\n        \"canGetAnotherSms\": false,\n        \"refunded\": true,\n        \"source\": \"api\",\n        \"createdAt\": \"2026-02-23T09:53:31.539Z\",\n        \"completedAt\": null,\n        \"cancelledAt\": \"2026-02-23T09:54:22.302Z\",\n        \"expiredAt\": null\n      },\n      {\n        \"activationId\": \"112778701\",\n        \"phoneNumber\": \"254770368284\",\n        \"serviceCode\": \"wa\",\n        \"countryId\": 8,\n        \"price\": 0.53,\n        \"status\": \"cancelled\",\n        \"code\": null,\n        \"verificationType\": null,\n        \"canGetAnotherSms\": false,\n        \"refunded\": true,\n        \"source\": \"api\",\n        \"createdAt\": \"2026-02-23T09:51:03.737Z\",\n        \"completedAt\": null,\n        \"cancelledAt\": \"2026-02-23T09:53:05.478Z\",\n        \"expiredAt\": null\n      },\n      {\n        \"activationId\": \"110900529\",\n        \"phoneNumber\": \"639543321066\",\n        \"serviceCode\": \"wa\",\n        \"countryId\": 4,\n        \"price\": 0.51,\n        \"status\": \"active\",\n        \"code\": null,\n        \"verificationType\": null,\n        \"canGetAnotherSms\": false,\n        \"refunded\": false,\n        \"source\": \"api\",\n        \"createdAt\": \"2026-02-22T14:06:01.281Z\",\n        \"completedAt\": null,\n        \"cancelledAt\": null,\n        \"expiredAt\": null\n      }\n    ],\n    \"total\": 21,\n    \"limit\": 50,\n    \"offset\": 0\n  },\n  \"errors\": []\n}\n\n

Activation record fields

Each item in data.activations[] includes:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Notes
`activationId`	string	Activation identifier
`phoneNumber`	string	Virtual phone number
`serviceCode`	string	Service identifier (e.g., `wa`)
`countryId`	number	Country identifier
`price`	number	Charged amount
`status`	string	e.g., `active`, `cancelled`, `completed`
`code`	string	null
`verificationType`	string	null
`canGetAnotherSms`	boolean	W.

","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-API-Key"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"50d0d309-24c7-48ad-88ad-d76f97ca787d","id":"50d0d309-24c7-48ad-88ad-d76f97ca787d","name":"Proxy-Hunks","type":"collection"}},"urlObject":{"protocol":"http","path":["api","v1","reseller","virtual-numbers","history"],"host":["telegram","proxyhunks","xyz"],"query":[],"variable":[]}},"response":[],"_postman_id":"73d2fb60-c38d-4daf-a064-12a13aa190a9"},{"name":"Cancel Activation Purchase","id":"a9027016-49c3-4986-b994-e734b65d9fee","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"http://telegram.proxyhunks.xyz/api/v1/reseller/virtual-numbers/cancel/121169158","description":"

Cancel Activation Purchase

Cancels (voids) a virtual number activation purchase.

Use this endpoint when you no longer need an activation and want to mark it as cancelled (often resulting in a refund depending on provider rules).

Authentication

This endpoint is authenticated.

Use the same auth mechanism configured for the rest of the Proxy-Hunks collection (commonly an API key / Bearer token).
\n
If you receive 401/403, verify your token/key and that it is being sent in the required header.
\n

Request

Method: POST

Path: /api/v1/reseller/virtual-numbers/cancel/:activationId

Path parameter

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Param	Type	Required	Description
`activationId`	string/number	Yes	The activation (purchase) identifier to cancel.

Example request

POST {{baseUrl}}/api/v1/reseller/virtual-numbers/cancel/120817600\nAuthorization: Bearer {{token}}\n\n

\n
Replace {{baseUrl}} and auth header with whatever your environment/collection uses.
\n

Responses

Success (200) — success cancelled

Explicit example for a successfully cancelled activation purchase:

{\n  \"status\": \"success\",\n  \"data\": {\n    \"activationId\": \"121169158\",\n    \"status\": \"cancelled\",\n    \"refundAmount\": 0.54,\n    \"balance\": 496.28,\n    \"currency\": \"USD\"\n  },\n  \"errors\": []\n}\n\n

On success, the activation will be marked as cancelled.

\n
If you need to confirm the final status/timestamps, call Get the Activation History and verify the activation record shows status: \"cancelled\" and has a non-null cancelledAt.
\n

Error (400) — already cancelled

If you attempt to cancel an activation that is already cancelled, the API may return:

{\n  \"status\": \"error\",\n  \"data\": null,\n  \"errors\": [\n    {\n      \"message\": \"Activation is already cancelled\",\n      \"code\": 400,\n      \"customData\": null\n    }\n  ]\n}\n\n

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-API-Key"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"50d0d309-24c7-48ad-88ad-d76f97ca787d","id":"50d0d309-24c7-48ad-88ad-d76f97ca787d","name":"Proxy-Hunks","type":"collection"}},"urlObject":{"protocol":"http","path":["api","v1","reseller","virtual-numbers","cancel","121169158"],"host":["telegram","proxyhunks","xyz"],"query":[],"variable":[]}},"response":[],"_postman_id":"a9027016-49c3-4986-b994-e734b65d9fee"}],"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-API-Key"},{"key":"value","value":""}]}},"event":[{"listen":"prerequest","script":{"id":"ee3b3ed2-d93e-4de0-b61e-6bca19e03ac2","type":"text/javascript","packages":{},"requests":{},"exec":[""]}},{"listen":"test","script":{"id":"fc493a76-a573-4353-8621-b73054c8dd0e","type":"text/javascript","packages":{},"requests":{},"exec":[""]}}]}