To use it, you will need your API key, which you can obtain on your Profile page.

The API is similar to the SmsActivate API. Currently, all API calls are made via GET requests. Each call must contain an action parameter corresponding to the method name and an api_key parameter containing your API key.

Base URL:

https://quix.email/stubs/handler_api.php

Available methods:

getBalance

https://quix.email/stubs/handler_api.php?action=getBalance&api_key=API_KEY

Returns your account balance. Example response:

3.14 - your balance is 3.14 USD.

getNumber

https://quix.email/stubs/handler_api.php?action=getNumber&api_key=API_KEY&service=SERVICE&country=COUNTRY&maxPrice=0.2

Get the number for the service SERVICE and the country COUNTRY. Example responses:

ACCESS_NUMBER:1234567890:12345678901 - successful receipt of the number

NO_NUMBERS - no number available

getStatus

https://quix.email/stubs/handler_api.php?action=getStatus&api_key=API_KEY&id=ACTIVATION_ID

Returns the activation status with an ID equal to ACTIVATION_ID. Response examples:

STATUS_WAIT_CODE - the code has not yet been received

STATUS_OK:123456 - code received (123456)

setStatus

https://quix.email/stubs/handler_api.php?action=setStatus&api_key=API_KEY&id=ACTIVATION_ID&status=STATUS

Change the activation status of ACTIVATION_ID to STATUS. Available STATUS values:

1 - notify that the SMS has been sent
3 - request a re-receipt of the code
6 - complete activation
8 - cancel activation with a refund

Sample responses:

ACCESS_CANCEL - activation was successfully canceled

BAD_STATUS - invalid status sent

https://quix.email/stubs/handler_api.php?action=getHistory&api_key=API_KEY&start=TIME_FROM&end=TIME_TO&offset=OFFSET&size=SIZE

Get activation history. You can specify a time frame from TIME_FROM to TIME_TO (in Unix format). You can also specify the record to start retrieval from (OFFSET) and the number of records to retrieve (SIZE, up to 100). Response example:

[{"id":1234567890,"date":"2026-01-04 02:37:30","phone":"12345678901","code":"123456","cost":0.0123,"status":"STATUS_OK"}]

getPrices

https://quix.email/stubs/handler_api.php?action=getPrices&api_key=API_KEY&service=SERVICE&country=COUNTRY

Returns a list of prices and the number of rooms for the service SERVICE and country COUNTRY. You can specify the country and service, or one of these parameters. The response will be in JSON format. Example response:

{"10":{"ig":{"cost":0.0225,"count":401}}} - 401 numbers are available for the Instagram+Threads service in Vietnam, each number costs 0.0225 USD.

https://quix.email/stubs/handler_api.php?action=getCountries&api_key=API_KEY

Get a list of available countries. Response example:

[{"id": 10,"en": "Vietnam","ru": "Вьетнам"}]

https://quix.email/stubs/handler_api.php?action=getServicesList&api_key=API_KEY

Get a list of available services. Response example:

[{"code": "ig","name": "Instagram+Threads"}]