Status Codes

Status Codes

All ThingSpace SMS API resources use this set of status codes in responses.

HTTP Status Error Code Message Suggested Action
200
400 INVALID_ACCESS The access policy denied the resource operation for this user
400 INVALID_REQUEST Recipient must be at least 10 digits number Verify that the recipient value is a valid phone number, and then resend the request.
400 INVALID_REQUEST SenderAddress must be 10 or 12 digits number Verify that you have entered your long code correctly in the senderAddress field and then resend the request.
400 INVALID_REQUEST Field must be not empty Verify that you have supplied values for all required fields, and then resend the request.
400 INVALID_REQUEST Field must be not Null Verify that you have supplied values for all required fields, and then resend the request.
400 INVALID_REQUEST An element value format is inappropriate or incorrect. Check that you are using the correct value types for each field, and then resend the request.
400 INVALID_REQUEST All recipients not optin The recipient number has not opted in to your service. Do not send messages to that number until they have opted in.
403 FORBIDDEN_ERROR User doesn’t own this code Use a long code that belongs to your account in the senderAddress field.
403 FORBIDDEN_ERROR Reach api call quota You have sent the maximum number of messages allowed in your SMS trial.
403 FORBIDDEN_ERROR Trial is going to valid from: 2016-10-11T00:00:00-04:00 Your SMS trial has not started yet. Wait until the date and time given before sending SMS messages.
403 FORBIDDEN_ERROR Trial is expired at: 2016-10-11T00:00:00-04:00 Your SMS trial has expired.
403 FORBIDDEN_ERROR Access to view or modify the resource identified by the Request-URI is forbidden
404 NOT_FOUND Could not find callback with specified code and callback type Verify the long code and callback type and then try the request again.
409 CONFLICT_ERROR A callback already exists for the provided code, message type, and callback type Deregister the callbackType if you want to set a new endpoint.
500 SERVER_ERROR The server failed to fulfill an apparently valid request
503 SERVICE_UNAVAILABLE Unable to provide service
503 SERVICE_UNAVAILABLE Exceed max message throttling rate allowed. Send fewer SMS messages per minute.