JuicySMS - The leading SMS verification service

Introduction

The authorization is simple, you go to your account page and there you can generate an API Key. This API Key gives access to your account, so watch out with whom you share it! Once you have created an API Key, you can proceed to the functions that the API offers. The functions that are offered can be viewed below. Each of these functions can be invoked by providing the correct parameters with a GET request. The server will always give status code 200, only the body of the response will differ.

NOTE: The first version of this API has just been released. If you have suggestions, contact the support and we'll settle it for you!

MakeOrder - GET

Endpoint: https://juicysms.com/api/makeorder?key=APIKEY&serviceId=SERVICEID&country=NL Method: GET

To make an order you need to send a request to the endpoint above providing the right serviceId. To view the serviceIds go to your account page and click 'Show API ID's On Service Page'.

Parameter	Description
key	Your API Key. (Required)
serviceId	The ID of the service you wish to make an order for. (Required)
country	Specify the country you wish the number to be from. Options: USA, NL or UK (Optional NL by default)

Possible Responses:


NO_PHONE_AVAILABLE

- There is unfortunately no phone available for the specified service.


ORDER_ALREADY_OPEN_{ORDER_ID}

- There is an order already open. Please finish or cancel this one before making a new order.


NO_BALANCE

- There is unfortunately not enough balance on your account for this order.

Success:
ORDER_ID_{ORDER_ID}_NUMBER_{PHONE_NUMBER} - Your order has been successfully made.

GetSMS - GET

Endpoint: https://juicysms.com/api/getsms?key=APIKEY&orderId=ORDERID Method: GET

With this method you can see the SMS that came in for the order.

Parameter	Description
key	Your API Key. (Required)
orderId	The ID of the order you wish to check if a SMS came in. (Required)

Possible Responses:


ORDER_EXPIRED

- The order has been canceled or has been expired.


WAITING

- The order is still open waiting for a SMS to come in.

Success:
SUCCESS_{SMS_CONTENT} - Your SMS has been successfully received.

CancelOrder - GET

Endpoint: https://juicysms.com/api/cancelorder?key=APIKEY&orderId=ORDERID Method: GET

With this method you can cancel an active order.

Parameter	Description
key	Your API Key. (Required)
orderId	The ID of the order you wish to cancel. (Required)

Possible Responses:


ORDER_ALREADY_EXPIRED

- The order has already been expired.


ORDER_ALREADY_COMPLETED

- The order has already been completed.

Success:
ORDER_CANCELED - Your order has been canceled.

SkipNumber - GET

Endpoint: https://juicysms.com/api/skipnumber?key=APIKEY&orderId=ORDERID Method: GET

With this method you can skip a number of an active order so you dont get it again in the future.

Parameter	Description
key	Your API Key. (Required)
orderId	The ID of the order you wish to skip the number on. (Required)

Possible Responses:


ORDER_ALREADY_EXPIRED

- The order has already been expired.


ORDER_ALREADY_COMPLETED

- The order has already been completed.

Success:
NUMBER_SKIPPED_ORDER_CANCELED - Your order has been canceled and the number has been skipped. You can make a new order with a fresh number.

GetBalance - GET

Endpoint: https://juicysms.com/api/getbalance?key=APIKEY Method: GET

With this method you can get your current balance in USD.

Parameter	Description
key	Your API Key. (Required)

Possible Responses:

{YOUR_BALANCE} - Your current balance in USD

Reuse Number - GET

Endpoint: https://juicysms.com/api/reuse?key=APIKEY&orderId=ORDERID Method: GET

In case you wish to use the same number again for the same service as an already completed order you can use this API call.
NOTE: Re-using is only available for a very short time after the initial order. (A few hours usually)

Parameter	Description
key	Your API Key. (Required)
orderId	The ID of the order you already completed and wish to re-use. (Required)

Possible Responses:


NUMBER_OFFLINE

- The number has been replaced and is gone.


ORDER_ALREADY_OPEN_{ORDER_ID}

- There is an order already open. Please finish or cancel this one before making a new order.


NO_BALANCE

- There is unfortunately not enough balance on your account for this order.

Success:
ORDER_ID_{ORDER_ID}_NUMBER_{PHONE_NUMBER} - Your order has been successfully made.