To check a message from the API a GET request is sent, and a JSON response is sent back with the appropriate HTTP respone code. The following parameters are required.

ParameterDescriptionPossible Values
keyaccount authentication key
secretaccount authentication secret
message-idID for the message to query

You can find our API functions on the menu on the right-hand side of this page. If you need assistance with connecting using our SMS RESTful API we will be happy to assist and review your requirements. Please send your requests to info@smsjuice.com.

Request Examples

Curl

        curl --include \
            https://api.smsjuice.com/{key}/{secret}/{message-id}/query
        

Response Examples

Successful Response Example [HTTP RESPONSE 200 (OK)]

        {"message_id":"dd1hzzkwr0x341s","message_status":"pending","delivery_status":"unknown","delivery_time":"none"}
        

Response explanation

KeyPossible Value
message_idMessage ID of message being checked
message_status[sent],[pending]
delivery_status[unknown], [undeliverable], [rejected], [expired], [delivered]
delivery_time[YYYY-MM-dd HH:mm:ss] Or [none]

Failed Response Example [HTTP RESPONSES : 400 (BAD_REQUEST), 401 (UNAUTHORIZED), 500 (INTERNAL_SERVER_ERROR)]

             {"submit":"failed","error":"invalid_credentials"}