Registration

API information

API query execution for Activations

Full list of services, prices and number quantity

To call the API method, you need to send GET request over the HTTPS protocol to the specified URL:

https://www.gogetsms.com/handler_api.php?api_key=$api_key&action=getNumbersStatus&country=$country

Default Latvia

Get up-to-date prices for services for verification

https://www.gogetsms.com/handler_api.php?api_key=$api_key&action=getNumbersStatus&country=$country

IP address cannot exceed 10 requests per minute

User balance request

To call the API method, you need to send GET request over the HTTPS protocol to the specified URL:

https://www.gogetsms.com/handler_api.php?api_key=$api_key&action=getBalance

With a positive response from the server, you will receive a reply in the form:

ACCESS_BALANCE:$balance

If a server error occurs, you will receive a response in the form:

BAD_KEY

Instead of {KEY}, specify the API key, which you can find in the dashboard under My Account section.

Request full list of services, prices and number quantity for a specific country

To call the API method, you need to send GET request over the HTTPS protocol to the specified URL:

https://www.gogetsms.com/handler_api.php?api_key=$api_key&action=getPrices&country=$country

If a server error occurs, you will receive a response in the form:

BAD_COUNTRY

Instead of {KEY}, specify the API key, which you can find in the dashboard under My Account section.

Instead of {COUNTRY}, specify the country you can get when requesting list_services.

Request a phone number for a specific service

To call the API method, you need to send GET request over the HTTPS protocol to the specified URL:

https://www.gogetsms.com/handler_api.php?api_key=$api_key&action=getNumber&service=$service&country=$country

With a positive response from the server, you will receive a reply in the form:

ACCESS_NUMBER:$id:$number

If a server error occurs, you will receive a response in the form:

BAD_ACTION
BAD_SERVICE
BAD_KEY

Instead of {KEY}, specify the API key, which you can find in the dashboard under My Account section.

Instead of {SERVICE}, specify the service that you can get when requesting list_services.

Instead of {COUNTRY}, specify the country you can get when requesting list_services.

Request for an SMS to the ordered phone number

To call the API method, you need to send GET request over the HTTPS protocol to the specified URL:

https://www.gogetsms.com/handler_api.php?api_key=$api_key&action=getStatus&id=$id

If SMS hasn't been received, you get an answer:

STATUS_WAIT_CODE

If the time of the application is over:

STATUS_CANCEL

If the text of the message is received:

STATUS_OK:$code

If a server error occurs, you will receive a response in the form:

NO_ACTIVATION

Instead of {KEY}, specify the API key, which you can find in the dashboard under My Account section.

Instead of {ORDER ID}, enter your order ID.

Cancellation of the order for the received number

To call the API method, you need to send GET request over the HTTPS protocol to the specified URL:

https://www.gogetsms.com/handler_api.php?api_key=$api_key&action=setStatus&status=$status&id=$id

If the order has been cancelled successfully, you get an answer:

ACCESS_CANCEL 6 - Close order
8 - Cancel order

Instead of {KEY}, specify the API key, which you can find in the dashboard under My Account section.

Instead of {ORDER ID}, enter your order ID.

API query execution for Rental

Request available countries and services

To call the API method, you need to send GET request over the HTTPS protocol to the specified URL:

https://www.gogetsms.com/handler_api.php?api_key=$api_key&action=getRentServicesAndCountries&rent_time=$time&country=$country

The response of the service will be in json format

$time * - rental time in hours (Default: 4 hours). (4,24,72,168,360,720)

IP address cannot exceed 10 requests per minute

Order a virtual number rental

To call the API method, you need to send GET request over the HTTPS protocol to the specified URL:

https://www.gogetsms.com/handler_api.php?api_key=$api_key&action=getRentNumber&service=$service&rent_time=$time&country=$country

The response of the service will be in json format

{"status":"success","phone":{"id":5322764,"endDate":"2023-05-20T19:23:57+03:00","number":37063356515,"cost":"5.00"}}

$time * - rental time in hours (Default: 4 hours). (4,24,72,168,360,720)

IP address cannot exceed 10 requests per minute

Get status for rent

To call the API method, you need to send GET request over the HTTPS protocol to the specified URL:

https://www.gogetsms.com/handler_api.php?api_key=$api_key&action=getRentStatus&id=$id

The response of the service will be in json format

{ "status": "success", "quantity": "2", "values": { "0": { "phoneFrom": "AUTHMSG", "text": "5", "date": "2023-05-20T19:23:57+03:00" }, "1": { "phoneFrom": "46717184720", "text": "4", "date": "2023-05-20T18:23:57+03:00" } } }

IP address cannot exceed 10 requests per minute

Rental Status Change

To call the API method, you need to send GET request over the HTTPS protocol to the specified URL:

https://www.gogetsms.com/handler_api.php?api_key=$api_key&action=setRentStatus&id=$id&status=$status

The status can be:

1 - Finish

2 - Cancel

List current activations

To call the API method, you need to send GET request over the HTTPS protocol to the specified URL:

https://www.gogetsms.com/handler_api.php?api_key=$api_key&action=getRentList

The response of the service will be in json format

{ "status": "success", "values": { "0": { "id": "123456", "phone": "37066253240", "endDate":"2023-05-20T20:23:57+03:00" }, "1": { "id": "123457", "phone": "31645879032", "endDate":"2023-05-20T19:23:57+03:00" } } }

IP address cannot exceed 10 requests per minute

Renew rent

To call the API method, you need to send GET request over the HTTPS protocol to the specified URL:

https://www.gogetsms.com/handler_api.php?api_key=$api_key&action=continueRentNumber&id=$id&rent_time=$time

The response of the service will be in json format

{"status":"success","phone":{"id":5322764,"endDate":"2023-05-20T19:23:57+03:00","number":37063356515,"cost":"5.00"}}

$time * - rental time in hours (Default: 4 hours). (4,24,72,168,360,720)

IP address cannot exceed 10 requests per minute