for developers

smsmode status codes

The smsmode API returns an HTTP status and code with every request. Generally, a 2xx code indicates success. Codes in the 4xx range indicate an error due to information provided in the request, such as authentication failure, missing required fields, or invalid parameters. Codes in the 5xx range are rare and typically indicate an error on our end.

Additional codes may be added in the future. If you encounter a code not listed here, please consult the HTTP specification for its definition.

2xx Success

Indicates that the client's request was successfully received, understood, and accepted.

200 OK

The request has succeeded.

201 Created

The request has been fulfilled and resulted in a new resource being created.

202 Accepted

The request has been accepted for processing, but the processing has not been completed.

204 No Content

The server successfully processed the request, but is not returning any content.

4xx Client Errors

Indicates that the client seems to have made an error. Please refer to the detailed error codes listed below for specific information about each error.

400 Bad Request

The server could not understand the request due to invalid syntax.

401 Unauthorized

Authentication is required and has failed or has not yet been provided.

403 Forbidden

The client does not have access rights to the content.

404 Not Found

The server can not find the requested resource.

405 Method Not Allowed

The method specified in the request is not allowed for the resource identified by the request URI.

406 Not Acceptable

The server cannot return the requested resource in the format the client requested.

415 Unsupported Media Type

The server is refusing to service the request because the payload is in a format not supported by this method on the target resource.

429 Too Many Requests

The user has sent too many requests in a given amount of time (rate limiting).

5xx Server Errors

Indicates that the server failed to fulfill a valid request. If you encounter these errors, please contact our support team at ticket.smsmode.com with the error context and timestamp.

500 Internal Server Error

The server encountered an unexpected condition that prevented it from fulfilling the request.

502 Bad Gateway

The server received an invalid response from the upstream server.

503 Service Unavailable

The server is not ready to handle the request, often due to maintenance or overload.

504 Gateway Timeout

The server did not receive a timely response from the upstream server.

API SMS Errors

400.001 – Bad Request

Status: 400
Message: Query parameter: startDate invalid
Detail: Must be today or earlier
{
  "title": "Bad Request",
  "message": "Query parameter: startDate invalid",
  "detail": "Must be today or earlier",
  "type": "https://dev.smsmode.com/sms/errors/400.001",
  "status": "400",
  "errorCode": "400.001"
}

400.002 – Bad Request

Status: 400
Message: Query parameter: endDate invalid
Detail: Must be today or earlier
{
  "title": "Bad Request",
  "message": "Query parameter: endDate invalid",
  "detail": "Must be today or earlier",
  "type": "https://dev.smsmode.com/sms/errors/400.002",
  "status": "400",
  "errorCode": "400.002"
}

400.003 – Bad Request

Status: 400
Message: Query parameter: page invalid
Detail: Must be greater than 1
{
  "title": "Bad Request",
  "message": "Query parameter: page invalid",
  "detail": "Must be greater than 1",
  "type": "https://dev.smsmode.com/sms/errors/400.003",
  "status": "400",
  "errorCode": "400.003"
}

400.004 – Bad Request

Status: 400
Message: Query parameter: pageSize invalid
Detail: Must be between 1 and 100
{
  "title": "Bad Request",
  "message": "Query parameter: pageSize invalid",
  "detail": "Must be between 1 and 100",
  "type": "https://dev.smsmode.com/sms/errors/400.004",
  "status": "400",
  "errorCode": "400.004"
}

400.006 – Bad Request

Status: 400
Message: Query parameter: startDate invalid format
Detail: Must be specified with valid ISO8601 format
{
  "title": "Bad Request",
  "message": "Query parameter: startDate invalid format",
  "detail": "Must be specified with valid ISO8601 format",
  "type": "https://dev.smsmode.com/sms/errors/400.006",
  "status": "400",
  "errorCode": "400.006"
}

400.007 – Bad Request

Status: 400
Message: Query parameter: endDate invalid format
Detail: Must be specified with valid ISO8601 format
{
  "title": "Bad Request",
  "message": "Query parameter: endDate invalid format",
  "detail": "Must be specified with valid ISO8601 format",
  "type": "https://dev.smsmode.com/sms/errors/400.007",
  "status": "400",
  "errorCode": "400.007"
}

400.008 – Bad Request

Status: 400
Message: Query parameter: startDate/endDate invalid
Detail: endDate must come after startDate
{
  "title": "Bad Request",
  "message": "Query parameter: startDate/endDate invalid",
  "detail": "endDate must come after startDate",
  "type": "https://dev.smsmode.com/sms/errors/400.008",
  "status": "400",
  "errorCode": "400.008"
}

400.009 – Bad Request

Status: 400
Message: Query parameter: page invalid format
Detail: Must be a number
{
  "title": "Bad Request",
  "message": "Query parameter: page invalid format",
  "detail": "Must be a number",
  "type": "https://dev.smsmode.com/sms/errors/400.009",
  "status": "400",
  "errorCode": "400.009"
}

400.010 – Bad Request

Status: 400
Message: Query parameter: pageSize invalid format
Detail: Must be a number
{
  "title": "Bad Request",
  "message": "Query parameter: pageSize invalid format",
  "detail": "Must be a number",
  "type": "https://dev.smsmode.com/sms/errors/400.010",
  "status": "400",
  "errorCode": "400.010"
}

400.020 – Bad Request

Status: 400
Message: Invalid character found in the request target
Detail: The valid characters are defined in RFC 7230 and RFC 3986
{
  "title": "Bad Request",
  "message": "Invalid character found in the request target",
  "detail": "The valid characters are defined in RFC 7230 and RFC 3986",
  "type": "https://dev.smsmode.com/sms/errors/400.020",
  "status": "400",
  "errorCode": "400.020"
}

400.021 – Bad Request

Status: 400
Message: Query parameter: startDate/endDate invalid
Detail: Period requested must not exceed 30 days
{
  "title": "Bad Request",
  "message": "Query parameter: startDate/endDate invalid",
  "detail": "Period requested must not exceed 30 days",
  "type": "https://dev.smsmode.com/sms/errors/400.021",
  "status": "400",
  "errorCode": "400.021"
}

400.022 – Bad Request

Status: 400
Message: Query parameter: searchBy[direction] invalid
Detail: Must be MT or MO
{
  "title": "Bad Request",
  "message": "Query parameter: searchBy[direction] invalid",
  "detail": "Must be MT or MO",
  "type": "https://dev.smsmode.com/sms/errors/400.022",
  "status": "400",
  "errorCode": "400.022"
}

400.023 – Bad Request

Status: 400
Message: Query parameter: searchBy[encoding] invalid
Detail: Must be GSM7 or UNICODE
{
  "title": "Bad Request",
  "message": "Query parameter: searchBy[encoding] invalid",
  "detail": "Must be GSM7 or UNICODE",
  "type": "https://dev.smsmode.com/sms/errors/400.023",
  "status": "400",
  "errorCode": "400.023"
}

400.024 – Bad Request

Status: 400
Message: Query parameter: searchBy[status] invalid
Detail: Must be ENROUTE, DELIVERED, UNDELIVERABLE, UNDELIVERED or UNKNOWN
{
  "title": "Bad Request",
  "message": "Query parameter: searchBy[status] invalid",
  "detail": "Must be ENROUTE, DELIVERED, UNDELIVERABLE, UNDELIVERED or UNKNOWN",
  "type": "https://dev.smsmode.com/sms/errors/400.024",
  "status": "400",
  "errorCode": "400.024"
}

400.025 – Bad Request

Status: 400
Message: Request body: recipient.to invalid
Detail: Must be specified
{
  "title": "Bad Request",
  "message": "Request body: recipient.to invalid",
  "detail": "Must be specified",
  "type": "https://dev.smsmode.com/sms/errors/400.025",
  "status": "400",
  "errorCode": "400.025"
}

400.026 – Bad Request

Status: 400
Message: Request body: recipient invalid
Detail: Must be a JSON object
{
  "title": "Bad Request",
  "message": "Request body: recipient invalid",
  "detail": "Must be a JSON object",
  "type": "https://dev.smsmode.com/sms/errors/400.026",
  "status": "400",
  "errorCode": "400.026"
}

400.027 – Bad Request

Status: 400
Message: Request body: recipient invalid
Detail: Must be specified
{
  "title": "Bad Request",
  "message": "Request body: recipient invalid",
  "detail": "Must be specified",
  "type": "https://dev.smsmode.com/sms/errors/400.027",
  "status": "400",
  "errorCode": "400.027"
}

400.028 – Bad Request

Status: 400
Message: Request body: recipient.to invalid
Detail: Must be a string
{
  "title": "Bad Request",
  "message": "Request body: recipient.to invalid",
  "detail": "Must be a string",
  "type": "https://dev.smsmode.com/sms/errors/400.028",
  "status": "400",
  "errorCode": "400.028"
}

400.029 – Bad Request

Status: 400
Message: Request body: recipient.to invalid
Detail: The valid format is defined in E.164 standard
{
  "title": "Bad Request",
  "message": "Request body: recipient.to invalid",
  "detail": "The valid format is defined in E.164 standard",
  "type": "https://dev.smsmode.com/sms/errors/400.029",
  "status": "400",
  "errorCode": "400.029"
}

400.030 – Bad Request

Status: 400
Message: Request body: from invalid
Detail: Must be a string
{
  "title": "Bad Request",
  "message": "Request body: from invalid",
  "detail": "Must be a string",
  "type": "https://dev.smsmode.com/sms/errors/400.030",
  "status": "400",
  "errorCode": "400.030"
}

400.031 – Bad Request

Status: 400
Message: Request body: from invalid
Detail: Size must be between 1 and 11 characters
{
  "title": "Bad Request",
  "message": "Request body: from invalid",
  "detail": "Size must be between 1 and 11 characters",
  "type": "https://dev.smsmode.com/sms/errors/400.031",
  "status": "400",
  "errorCode": "400.031"
}

400.032 – Bad Request

Status: 400
Message: Request body: body invalid
Detail: Must be specified
{
  "title": "Bad Request",
  "message": "Request body: body invalid",
  "detail": "Must be specified",
  "type": "https://dev.smsmode.com/sms/errors/400.032",
  "status": "400",
  "errorCode": "400.032"
}

400.033 – Bad Request

Status: 400
Message: Request body: body invalid
Detail: Must be a JSON object
{
  "title": "Bad Request",
  "message": "Request body: body invalid",
  "detail": "Must be a JSON object",
  "type": "https://dev.smsmode.com/sms/errors/400.033",
  "status": "400",
  "errorCode": "400.033"
}

400.034 – Bad Request

Status: 400
Message: Request body: body.text invalid
Detail: Must be specified
{
  "title": "Bad Request",
  "message": "Request body: body.text invalid",
  "detail": "Must be specified",
  "type": "https://dev.smsmode.com/sms/errors/400.034",
  "status": "400",
  "errorCode": "400.034"
}

400.035 – Bad Request

Status: 400
Message: Request body: body.text invalid
Detail: Must be a string
{
  "title": "Bad Request",
  "message": "Request body: body.text invalid",
  "detail": "Must be a string",
  "type": "https://dev.smsmode.com/sms/errors/400.035",
  "status": "400",
  "errorCode": "400.035"
}

400.037 – Bad Request

Status: 400
Message: Request body: body.encoding invalid
Detail: Must be GSM7 or UNICODE
{
  "title": "Bad Request",
  "message": "Request body: body.encoding invalid",
  "detail": "Must be GSM7 or UNICODE",
  "type": "https://dev.smsmode.com/sms/errors/400.037",
  "status": "400",
  "errorCode": "400.037"
}

400.038 – Bad Request

Status: 400
Message: Request body: body.encoding is different from the campaign encoding
Detail: Must be same as Campaign encoding
{
  "title": "Bad Request",
  "message": "Request body: body.encoding is different from the campaign encoding",
  "detail": "Must be same as Campaign encoding",
  "type": "https://dev.smsmode.com/sms/errors/400.038",
  "status": "400",
  "errorCode": "400.038"
}

400.040 – Bad Request

Status: 400
Message: Request body: sentDate invalid
Detail: Must be a string in ISO 8601 date format
{
  "title": "Bad Request",
  "message": "Request body: sentDate invalid",
  "detail": "Must be a string in ISO 8601 date format",
  "type": "https://dev.smsmode.com/sms/errors/400.040",
  "status": "400",
  "errorCode": "400.040"
}

400.041 – Bad Request

Status: 400
Message: Request body: sentDate invalid
Detail: Must be a future date
{
  "title": "Bad Request",
  "message": "Request body: sentDate invalid",
  "detail": "Must be a future date",
  "type": "https://dev.smsmode.com/sms/errors/400.041",
  "status": "400",
  "errorCode": "400.041"
}

400.042 – Bad Request

Status: 400
Message: Request body: sentDate invalid
Detail: Must not be more than 10 years older than now
{
  "title": "Bad Request",
  "message": "Request body: sentDate invalid",
  "detail": "Must not be more than 10 years older than now",
  "type": "https://dev.smsmode.com/sms/errors/400.042",
  "status": "400",
  "errorCode": "400.042"
}

400.043 – Bad Request

Status: 400
Message: Request body: refClient invalid
Detail: Must be a string
{
  "title": "Bad Request",
  "message": "Request body: refClient invalid",
  "detail": "Must be a string",
  "type": "https://dev.smsmode.com/sms/errors/400.043",
  "status": "400",
  "errorCode": "400.043"
}

400.044 – Bad Request

Status: 400
Message: Request body: refClient invalid
Detail: Size must be between 3 and 140 characters
{
  "title": "Bad Request",
  "message": "Request body: refClient invalid",
  "detail": "Size must be between 3 and 140 characters",
  "type": "https://dev.smsmode.com/sms/errors/400.044",
  "status": "400",
  "errorCode": "400.044"
}

400.045 – Bad Request

Status: 400
Message: Request body: callbackUrlStatus invalid
Detail: Must be a string
{
  "title": "Bad Request",
  "message": "Request body: callbackUrlStatus invalid",
  "detail": "Must be a string",
  "type": "https://dev.smsmode.com/sms/errors/400.045",
  "status": "400",
  "errorCode": "400.045"
}

400.046 – Bad Request

Status: 400
Message: Request body: callbackUrlStatus invalid
Detail: Size must not exceed 255 characters
{
  "title": "Bad Request",
  "message": "Request body: callbackUrlStatus invalid",
  "detail": "Size must not exceed 255 characters",
  "type": "https://dev.smsmode.com/sms/errors/400.046",
  "status": "400",
  "errorCode": "400.046"
}

400.047 – Bad Request

Status: 400
Message: Request body: callbackUrlStatus invalid
Detail: Must be a valid URL
{
  "title": "Bad Request",
  "message": "Request body: callbackUrlStatus invalid",
  "detail": "Must be a valid URL",
  "type": "https://dev.smsmode.com/sms/errors/400.047",
  "status": "400",
  "errorCode": "400.047"
}

400.048 – Bad Request

Status: 400
Message: Request body: callbackUrlMo invalid
Detail: Must be a string
{
  "title": "Bad Request",
  "message": "Request body: callbackUrlMo invalid",
  "detail": "Must be a string",
  "type": "https://dev.smsmode.com/sms/errors/400.048",
  "status": "400",
  "errorCode": "400.048"
}

400.049 – Bad Request

Status: 400
Message: Request body: callbackUrlMo invalid
Detail: Size must not exceed 255 characters
{
  "title": "Bad Request",
  "message": "Request body: callbackUrlMo invalid",
  "detail": "Size must not exceed 255 characters",
  "type": "https://dev.smsmode.com/sms/errors/400.049",
  "status": "400",
  "errorCode": "400.049"
}

400.050 – Bad Request

Status: 400
Message: Request body: callbackUrlMo invalid
Detail: Must be a valid URL
{
  "title": "Bad Request",
  "message": "Request body: callbackUrlMo invalid",
  "detail": "Must be a valid URL",
  "type": "https://dev.smsmode.com/sms/errors/400.050",
  "status": "400",
  "errorCode": "400.050"
}

400.051 – Bad Request

Status: 400
Message: Request body invalid
Detail: Missing JSON request body
{
  "title": "Bad Request",
  "message": "Request body invalid",
  "detail": "Missing JSON request body",
  "type": "https://dev.smsmode.com/sms/errors/400.051",
  "status": "400",
  "errorCode": "400.051"
}

400.052 – Bad Request

Status: 400
Message: Request body invalid
Detail: Request body must be a valid JSON
{
  "title": "Bad Request",
  "message": "Request body invalid",
  "detail": "Request body must be a valid JSON",
  "type": "https://dev.smsmode.com/sms/errors/400.052",
  "status": "400",
  "errorCode": "400.052"
}

400.053 – Bad Request

Status: 400
Message: Query parameter: searchBy[to] invalid
Detail: Must be a valid phone number
{
  "title": "Bad Request",
  "message": "Query parameter: searchBy[to] invalid",
  "detail": "Must be a valid phone number",
  "type": "https://dev.smsmode.com/sms/errors/400.053",
  "status": "400",
  "errorCode": "400.053"
}

400.064 – Bad Request

Status: 400
Message: Request body: recipients invalid
Detail: Must be specified
{
  "title": "Bad Request",
  "message": "Request body: recipients invalid",
  "detail": "Must be specified",
  "type": "https://dev.smsmode.com/sms/errors/400.064",
  "status": "400",
  "errorCode": "400.064"
}

400.065 – Bad Request

Status: 400
Message: Request body: recipients invalid
Detail: Must be a JSON object
{
  "title": "Bad Request",
  "message": "Request body: recipients invalid",
  "detail": "Must be a JSON object",
  "type": "https://dev.smsmode.com/sms/errors/400.065",
  "status": "400",
  "errorCode": "400.065"
}

400.066 – Bad Request

Status: 400
Message: Request body: {fieldName} invalid
Detail: Must be specified
{
  "title": "Bad Request",
  "message": "Request body: {fieldName} invalid",
  "detail": "Must be specified",
  "type": "https://dev.smsmode.com/sms/errors/400.066",
  "status": "400",
  "errorCode": "400.066"
}

400.067 – Bad Request

Status: 400
Message: Request body: {fieldName} invalid
Detail: Must be a string
{
  "title": "Bad Request",
  "message": "Request body: {fieldName} invalid",
  "detail": "Must be a string",
  "type": "https://dev.smsmode.com/sms/errors/400.067",
  "status": "400",
  "errorCode": "400.067"
}

400.068 – Bad Request

Status: 400
Message: Request body: {fieldName} invalid
Detail: The valid format is defined in E.164 standard
{
  "title": "Bad Request",
  "message": "Request body: {fieldName} invalid",
  "detail": "The valid format is defined in E.164 standard",
  "type": "https://dev.smsmode.com/sms/errors/400.068",
  "status": "400",
  "errorCode": "400.068"
}

400.072 – Bad Request

Status: 400
Message: Path parameter: campaignId invalid format
Detail: Must be a UUID
{
  "title": "Bad Request",
  "message": "Path parameter: campaignId invalid format",
  "detail": "Must be a UUID",
  "type": "https://dev.smsmode.com/sms/errors/400.072",
  "status": "400",
  "errorCode": "400.072"
}

400.073 – Bad Request

Status: 400
Message: Path parameter: messageId invalid format
Detail: Must be a UUID
{
  "title": "Bad Request",
  "message": "Path parameter: messageId invalid format",
  "detail": "Must be a UUID",
  "type": "https://dev.smsmode.com/sms/errors/400.073",
  "status": "400",
  "errorCode": "400.073"
}

400.074 – Bad Request

Status: 400
Message: Request body: sendDate and/or endDate invalid
Detail: Must not be more than 1 month between sentDate and endDate
{
  "title": "Bad Request",
  "message": "Request body: sendDate and/or endDate invalid",
  "detail": "Must not be more than 1 month between sentDate and endDate",
  "type": "https://dev.smsmode.com/sms/errors/400.074",
  "status": "400",
  "errorCode": "400.074"
}

400.075 – Bad Request

Status: 400
Message: Request body: sentDate/endDate invalid
Detail: endDate must come after sentDate
{
  "title": "Bad Request",
  "message": "Request body: sentDate/endDate invalid",
  "detail": "endDate must come after sentDate",
  "type": "https://dev.smsmode.com/sms/errors/400.075",
  "status": "400",
  "errorCode": "400.075"
}

400.076 – Bad Request

Status: 400
Message: Request body: {fieldName} invalid
Detail: Must be a JSON object
{
  "title": "Bad Request",
  "message": "Request body: {fieldName} invalid",
  "detail": "Must be a JSON object",
  "type": "https://dev.smsmode.com/sms/errors/400.076",
  "status": "400",
  "errorCode": "400.076"
}

400.079 – Bad Request

Status: 400
Message: Request body: recipients invalid
Detail: Size must not exceed 1000 items
{
  "title": "Bad Request",
  "message": "Request body: recipients invalid",
  "detail": "Size must not exceed 1000 items",
  "type": "https://dev.smsmode.com/sms/errors/400.079",
  "status": "400",
  "errorCode": "400.079"
}

400.080 – Bad Request

Status: 400
Message: Request body: {fieldName} invalid
Detail: Size must not exceed 5 items
{
  "title": "Bad Request",
  "message": "Request body: {fieldName} invalid",
  "detail": "Size must not exceed 5 items",
  "type": "https://dev.smsmode.com/sms/errors/400.080",
  "status": "400",
  "errorCode": "400.080"
}

400.081 – Bad Request

Status: 400
Message: Request body: {fieldName} invalid
Detail: Must be JSON Object
{
  "title": "Bad Request",
  "message": "Request body: {fieldName} invalid",
  "detail": "Must be JSON Object",
  "type": "https://dev.smsmode.com/sms/errors/400.081",
  "status": "400",
  "errorCode": "400.081"
}

400.082 – Bad Request

Status: 400
Message: Request body: body.text invalid
Detail: Size must be between 1 and 1530 characters for a GSM7 message
{
  "title": "Bad Request",
  "message": "Request body: body.text invalid",
  "detail": "Size must be between 1 and 1530 characters for a GSM7 message",
  "type": "https://dev.smsmode.com/sms/errors/400.082",
  "status": "400",
  "errorCode": "400.082"
}

400.083 – Bad Request

Status: 400
Message: Request body: body.text invalid
Detail: Size must be between 1 and 670 characters for a UNICODE message
{
  "title": "Bad Request",
  "message": "Request body: body.text invalid",
  "detail": "Size must be between 1 and 670 characters for a UNICODE message",
  "type": "https://dev.smsmode.com/sms/errors/400.083",
  "status": "400",
  "errorCode": "400.083"
}

400.117 – Bad Request

Status: 400
Message: Request body: sentDate invalid
Detail: Message already sent
{
  "title": "Bad Request",
  "message": "Request body: sentDate invalid",
  "detail": "Message already sent",
  "type": "https://dev.smsmode.com/sms/errors/400.117",
  "status": "400",
  "errorCode": "400.117"
}

400.118 – Bad Request

Status: 400
Message: Request body : sentDate invalid
Detail: Campaign already sent
{
  "title": "Bad Request",
  "message": "Request body : sentDate invalid",
  "detail": "Campaign already sent",
  "type": "https://dev.smsmode.com/sms/errors/400.118",
  "status": "400",
  "errorCode": "400.118"
}

400.119 – Bad Request

Status: 400
Message: Request body: {fieldName} invalid
Detail: Must be a string
{
  "title": "Bad Request",
  "message": "Request body: {fieldName} invalid",
  "detail": "Must be a string",
  "type": "https://dev.smsmode.com/sms/errors/400.119",
  "status": "400",
  "errorCode": "400.119"
}

400.120 – Bad Request

Status: 400
Message: Request body: {fieldName} invalid
Detail: Must be a string
{
  "title": "Bad Request",
  "message": "Request body: {fieldName} invalid",
  "detail": "Must be a string",
  "type": "https://dev.smsmode.com/sms/errors/400.120",
  "status": "400",
  "errorCode": "400.120"
}

400.121 – Bad Request

Status: 400
Message: Request body: {fieldName} invalid
Detail: Must be a string
{
  "title": "Bad Request",
  "message": "Request body: {fieldName} invalid",
  "detail": "Must be a string",
  "type": "https://dev.smsmode.com/sms/errors/400.121",
  "status": "400",
  "errorCode": "400.121"
}

400.122 – Bad Request

Status: 400
Message: Request body: {fieldName} invalid
Detail: Size must not exceed 255 characters
{
  "title": "Bad Request",
  "message": "Request body: {fieldName} invalid",
  "detail": "Size must not exceed 255 characters",
  "type": "https://dev.smsmode.com/sms/errors/400.122",
  "status": "400",
  "errorCode": "400.122"
}

400.123 – Bad Request

Status: 400
Message: Request body: {fieldName} invalid
Detail: Size must not exceed 255 characters
{
  "title": "Bad Request",
  "message": "Request body: {fieldName} invalid",
  "detail": "Size must not exceed 255 characters",
  "type": "https://dev.smsmode.com/sms/errors/400.123",
  "status": "400",
  "errorCode": "400.123"
}

400.124 – Bad Request

Status: 400
Message: Request body: sentDate invalid
Detail: Message sentDate is before campaign sentDate or after campaign endDate
{
  "title": "Bad Request",
  "message": "Request body: sentDate invalid",
  "detail": "Message sentDate is before campaign sentDate or after campaign endDate",
  "type": "https://dev.smsmode.com/sms/errors/400.124",
  "status": "400",
  "errorCode": "400.124"
}

400.125 – Bad Request

Status: 400
Message: Request Body: resources list invalid
Detail: Must not be empty
{
  "title": "Bad Request",
  "message": "Request Body: resources list invalid",
  "detail": "Must not be empty",
  "type": "https://dev.smsmode.com/sms/errors/400.125",
  "status": "400",
  "errorCode": "400.125"
}

400.126 – Bad Request

Status: 400
Message: Request Body: resources list invalid
Detail: Size must not exceed 1000 items
{
  "title": "Bad Request",
  "message": "Request Body: resources list invalid",
  "detail": "Size must not exceed 1000 items",
  "type": "https://dev.smsmode.com/sms/errors/400.126",
  "status": "400",
  "errorCode": "400.126"
}

400.127 – Bad Request

Status: 400
Message: Request body: body.stop invalid
Detail: Must be a boolean
{
  "title": "Bad Request",
  "message": "Request body: body.stop invalid",
  "detail": "Must be a boolean",
  "type": "https://dev.smsmode.com/sms/errors/400.127",
  "status": "400",
  "errorCode": "400.127"
}

400.152 – Bad Request

Status: 400
Message: Operation not permitted
Detail: Scheduled campaigns cannot be processed 30 minutes before the sentDate
{
  "title": "Bad Request",
  "message": "Operation not permitted",
  "detail": "Scheduled campaigns cannot be processed 30 minutes before the sentDate",
  "type": "https://dev.smsmode.com/sms/errors/400.152",
  "status": "400",
  "errorCode": "400.152"
}

400.153 – Bad Request

Status: 400
Message: Query parameter: searchBy[refClient] invalid
Detail: Size must be between 3 and 140 characters
{
  "title": "Bad Request",
  "message": "Query parameter: searchBy[refClient] invalid",
  "detail": "Size must be between 3 and 140 characters",
  "type": "https://dev.smsmode.com/sms/errors/400.153",
  "status": "400",
  "errorCode": "400.153"
}

400.154 – Bad Request

Status: 400
Message: Query parameter: searchBy[originMessageId] invalid
Detail: Must be a UUID
{
  "title": "Bad Request",
  "message": "Query parameter: searchBy[originMessageId] invalid",
  "detail": "Must be a UUID",
  "type": "https://dev.smsmode.com/sms/errors/400.154",
  "status": "400",
  "errorCode": "400.154"
}

400.155 – Bad Request

Status: 400
Message: Query parameter: searchBy[status] invalid
Detail: Must be SCHEDULED, ONGOING or ENDED
{
  "title": "Bad Request",
  "message": "Query parameter: searchBy[status] invalid",
  "detail": "Must be SCHEDULED, ONGOING or ENDED",
  "type": "https://dev.smsmode.com/sms/errors/400.155",
  "status": "400",
  "errorCode": "400.155"
}

400.156 – Bad Request

Status: 400
Message: Query parameter: sortBy[] invalid
Detail: Must be ASC or DESC
{
  "title": "Bad Request",
  "message": "Query parameter: sortBy[] invalid",
  "detail": "Must be ASC or DESC",
  "type": "https://dev.smsmode.com/sms/errors/400.156",
  "status": "400",
  "errorCode": "400.156"
}

401.001 – Unauthorized

Status: 401
Message: Header: X-Api-Key invalid
Detail: Invalid authentication credentials
{
  "title": "Unauthorized",
  "message": "Header: X-Api-Key invalid",
  "detail": "Invalid authentication credentials",
  "type": "https://dev.smsmode.com/sms/errors/401.001",
  "status": "401",
  "errorCode": "401.001"
}

403.001 – Forbidden

Status: 403
Message: Request body: from invalid
Detail: Not recognized, please contact support to authorize new sender IDs: https://smsmode.freshdesk.com/fr/support/tickets/new
{
  "title": "Forbidden",
  "message": "Request body: from invalid",
  "detail": "Not recognized, please contact support to authorize new sender IDs: https://smsmode.freshdesk.com/fr/support/tickets/new",
  "type": "https://dev.smsmode.com/sms/errors/403.001",
  "status": "403",
  "errorCode": "403.001"
}

403.004 – Forbidden

Status: 403
Message: Header: Credential invalid
Detail: Access denied, please contact your organisation administrator to execute the request
{
  "title": "Forbidden",
  "message": "Header: Credential invalid",
  "detail": "Access denied, please contact your organisation administrator to execute the request",
  "type": "https://dev.smsmode.com/sms/errors/403.004",
  "status": "403",
  "errorCode": "403.004"
}

403.005 – Forbidden

Status: 403
Message: Channel type mismatch
Detail: The type of the channel is not supported by this API
{
  "title": "Forbidden",
  "message": "Channel type mismatch",
  "detail": "The type of the channel is not supported by this API",
  "type": "https://dev.smsmode.com/sms/errors/403.005",
  "status": "403",
  "errorCode": "403.005"
}

404.002 – Not Found

Status: 404
Message: Path parameter: messageId invalid
Detail: Message resource not found
{
  "title": "Not Found",
  "message": "Path parameter: messageId invalid",
  "detail": "Message resource not found",
  "type": "https://dev.smsmode.com/sms/errors/404.002",
  "status": "404",
  "errorCode": "404.002"
}

404.003 – Not Found

Status: 404
Message: Request URL invalid
Detail: Endpoint not found
{
  "title": "Not Found",
  "message": "Request URL invalid",
  "detail": "Endpoint not found",
  "type": "https://dev.smsmode.com/sms/errors/404.003",
  "status": "404",
  "errorCode": "404.003"
}

404.007 – Not Found

Status: 404
Message: Path parameter: campaignId invalid
Detail: Campaign resource not found
{
  "title": "Not Found",
  "message": "Path parameter: campaignId invalid",
  "detail": "Campaign resource not found",
  "type": "https://dev.smsmode.com/sms/errors/404.007",
  "status": "404",
  "errorCode": "404.007"
}

405.001 – Method Not Allowed

Status: 405
Message: Request method invalid
Detail: Not allowed on this resource
{
  "title": "Method Not Allowed",
  "message": "Request method invalid",
  "detail": "Not allowed on this resource",
  "type": "https://dev.smsmode.com/sms/errors/405.001",
  "status": "405",
  "errorCode": "405.001"
}

406.001 – Not Acceptable

Status: 406
Message: Header: Accept invalid
Detail: Must be application/json
{
  "title": "Not Acceptable",
  "message": "Header: Accept invalid",
  "detail": "Must be application/json",
  "type": "https://dev.smsmode.com/sms/errors/406.001",
  "status": "406",
  "errorCode": "406.001"
}

415.001 – Unsupported Media Type

Status: 415
Message: Header: Content-Type invalid
Detail: Must be application/json
{
  "title": "Unsupported Media Type",
  "message": "Header: Content-Type invalid",
  "detail": "Must be application/json",
  "type": "https://dev.smsmode.com/sms/errors/415.001",
  "status": "415",
  "errorCode": "415.001"
}

Jump to error: (e.g. 401.001 or 400.072)