Copy page

GENERAL API INFORMATION

API Error codes

Movider API of http://api.movider.co might return the error codes:

Internal error

Code	Name	Description
1	ERR_SYSTEM_FAILURE	System failure.
4	ERR_DB_RECOVERING	Database recovering.
5	ERR_DB_RECOVERED_FAIL	Database recovered fail.
6	ERR_Q_RECOVERING	Queue recovering.
7	ERR_Q_RECOVERED_FAIL	Queue recovered fail.
8	ERR_CACHE_RECOVERING	Cache recovering.
9	ERR_CACHE_RECOVERED_FAIL	Cache recovered fail
10	ERR_CONNECTION_TIMEOUT	Connection timeout.
11	ERR_CONNECTION_REFUSED	Connection refused.
12	ERR_CONNECTION_FAILURE	Connection failure.
13	ERR_DB_FAILURE	Database failure.
14	ERR_Q_FAILURE	Queue failure.
15	ERR_CACHE_FAILURE	Cache failure
50	ERR_JSON_MARSHAL	Json marshal fail.
51	ERR_JSON_UNMARSHAL	Json unmarshal fail.
52	ERR_GIN_VARIABLE_NOT_FOUND	Gin variable not found.
53	ERR_QUERY_STRING	Querystring values fail.
54	ERR_MAKE_REQUEST	Can't make request for request to client.
55	ERR_IO_BODY	Can't read response from client.
60	ERR_POINTER	Pointer is nil
407	ERR_IP_WHITELIST_FAILURE	IP whitelist Error.
447	ERR_SENDER_FAILURE	Cannot get sender name.
449	ERR_BAD_COUNTRY_SPECIFIC_CONDITION	Something went wrong of country-specific service condition.
450	ERR_TAG	Can't create new tag.
455	ERR_RESERVED_WORD	Reserved word failed.
457	ERR_GATEWAY_CONFIG_ROUTE	Cannot get gateway config route.
459	ERR_DELIVERY_VERIFY_LOG_DAILY_FAILURE	DeliveryLogsVerifyDailyModel: InsertDuplicateKey return error
463	ERR_SMS_SCHEDULE_CREATE	Failed to create a new SMS bulk schedule
464	ERR_SMS_SCHEDULE_DETAIL_CREATE	Failed to create a new SMS schedule for the phone number
465	ERR_SMS_SCHEDULE_STATUS_UDATE	Failed to update the SMS schedule status
468	ERR_SMS_SCHEDULE_QUERY	SMS schedule query error
471	ERR_COUNTRY	Country Unavailable
478	ERR_SENDER_TH_FAILURE	Cannot find sender of Thailand in your sender list. Please contact support to add a new sender of Thailand.
479	ERR_CONTACTS	Something went wrong about contacts number.
480	ERR_CONTACTS_BLOCKLIST	Something went wrong about contacts blocklist number.
481	ERR_CONTACTS_BLOCKED	The number is contacts blocked.
482	ERR_GRPC_SMS_API	SMS Sending Procedure has error
483	ERR_GRPC_SMS_API	Can't Set cache for Jasmin DLR
484	ERR_GRPC_SMS_API	Hit rate limit

Error code can be

Code	Name	Description	Possible Cause	Next Action
0	NO_ERROR	No error.
2	ERR_METHOD_NOT_ALLOWED	Method Not Allowed.	The HTTP method is not supported for this endpoint.	Verify that you are using the correct HTTP method (GET/POST) according to the API documentation.
3	ERR_NOT_FOUND	Not Found.	The requested endpoint or resource does not exist.	Verify the API endpoint URL and ensure it is correct.
400	ERR_INVALID_SENDMSG_FORM	Send sms form is invalid.	One or more required parameters are missing or invalid.	Review the request body and ensure all mandatory parameters are provided in the correct format.
401	ERR_INVALID_APIKEY	api_key field of send sms form is invalid.	The API Key is invalid or does not exist.	Verify the API Key configured in your application.
402	ERR_INVALID_APISECRET	api_secret field of send sms form is invalid.	The API Secret is invalid.	Verify the API Secret configured in your application.
403	ERR_AUTHENTICATION_FAILED	Authentication failed.	The API Key and API Secret combination is incorrect.	Verify both API credentials. If the issue persists, regenerate your API credentials or contact Movider Support via help@movider.co
404	ERR_MEMBER_NOTFOUND	Member not found.	The account associated with the API credentials cannot be found.	Verify your account information or contact Movider Support via help@movider.co
405	ERR_MEMBER_BANNED	Member has been banned.	The account has been permanently banned.	Contact Movider Support for further assistance via help@movider.co.
406	ERR_MEMBER_SUSPENDED	Member has been suspended.	The account has been temporarily suspended.	Contact Movider Support to reactivate your account via help@movider.co
408	ERR_IP_WHITELIST_NOT_ALLOWED	Your IP not allowed.	The current IP address is not included in your IP Whitelist.	Send the request from an approved IP address or update the whitelist.
409	ERR_INVALID_TO	to field of send sms form is invalid.	The destination number parameter is missing or invalid.	Verify the destination number and ensure it follows E.164 format.
410	ERR_RECEIVER_NUMBER_OVER_LIMIT	Receiver number over limit.	Too many recipient numbers were included in one request.	Reduce the number of recipients per request according to the API limit.
411	ERR_INVALID_RECEIVER_NUMBER	Receivers number are invalid.	One or more recipient numbers are invalid.	Verify the phone number format and country code.
412	ERR_INVALID_TEXT	text field of send sms form is invalid.	The message content is empty or contains unsupported characters.	Ensure the message is not empty and contains valid text.
413	ERR_INVALID_CALLBACK_URL	callback_url of send sms form is invalid.	The callback URL format is invalid or unreachable.	Verify the callback URL and ensure it is publicly accessible.
414	ERR_INVALID_TAG	tag of send sms form is invalid.
415	ERR_REGION_NOT_SUPPORT	Region code not does not support.	SMS service is not supported in the requested region.	Verify that the destination country is supported by Movider.
416	ERR_INSUFFICIENT_BALANCE	Insufficient balance	Your available balance is insufficient to send SMS.	Top up your account before sending additional messages.
417	ERR_BALANCE_EXPIRED	Credit balance expired.	Your balance has expired.	Renew or top up your balance to continue using the service.
418	ERR_INVALID_CODE_LENGTH	Please choose code_length between 4 or 6 numbers.	The verification code length is outside the supported range.	Configure the verification code length according to API requirements.
419	ERR_INVALID_PIN_EXPIRE	The pin_expire field must be on range 120s - 600s	The PIN expiration time is invalid.	Set the PIN expiration time within the supported range.
420	ERR_INVALID_NEXT_EVENT_WAIT	The next_event_wait field must be on range 60s - (pin_expire-60)s	The waiting interval between verification events is invalid.	Configure a valid wait time according to the API documentation.
421	ERR_LANG_NOT_SUPPORT	The language code does not support.	The specified language is not supported.	Use one of the supported language codes.
422	ERR_ACKNOWLEDGE_FORM_INVALID	Acknowledge verify sms form is invalid.	The acknowledge request contains invalid or missing parameters.	Verify the request parameters before retrying.
423	ERR_CODE_INVALID	Code is invalid.	The verification code entered is incorrect.	Verify the code and try again.
424	ERR_REQUEST_ID_INVALID	Request id is invalid.	The Request ID is invalid or does not exist.	Verify the Request ID generated during the verification request.
425	ERR_VERIFY_SMS_NOTFOUND	Verify SMS not found.	No verification SMS record was found.	Verify the Request ID and ensure the verification request exists.
426	ERR_VERIFY_SMS_ALREADY_VERIFIED	Verify SMS has already verified.	This verification request has already been completed successfully.	No further action is required. Generate a new verification request if needed.
427	ERR_VERIFY_SMS_EXPIRED	Verify SMS has expired.	The verification code has expired.	Generate a new verification code and retry the verification process.
428	ERR_VERIFY_SMS_INPROGRESS	Verify SMS in progress.	The verification process is still active.	Wait until the current verification process completes before retrying.
429	ERR_VERIFY_SMS_FAILED	Verify SMS failed.	The verification process failed.	Verify the code and request information, then retry the verification.
430	ERR_CACHE_APIKEY_FORM_INVALID	Cache api_key form is invalid.
431	ERR_CACHE_IPWHITELIST_FORM_INVALID	Cache ip_whitelist form is invalid.
432	ERR_CACHE_R_FORM_INVALID	Cache rates of sms form is invalid.
433	ERR_CACHE_RV_FORM_INVALID	Cache rates of voice form is invalid.
434	ERR_CACHE_RVS_FORM_INVALID	Cache rates of verify successful form is invalid.
435	ERR_CACHE_MR_FORM_INVALID	Cache rates for member of sms form is invalid.
436	ERR_CACHE_MRV_FORM_INVALID	Cache rates for member of voice sms form is invalid.
437	ERR_CACHE_MRVS_FORM_INVALID	Cache rates for member of verify sms form is invalid.
438	ERR_CACHE_G_FORM_INVALID	Cache sms gateway form is invalid.
439	ERR_CACHE_GV_FORM_INVALID	Cache voice sms gateway form is invalid.
440	ERR_CACHE_VT_FORM_INVALID	Cache verify template form is invalid.
441	ERR_NUMBER_IS_VERIFYING	The receiver number is verifying.	The phone number is currently undergoing another verification process.	Wait for the current verification process to finish before submitting another request.
442	ERR_CANCEL_FORM_INVALID	Cancel verify sms form is invalid.	The cancellation request contains invalid parameters.	Verify the cancellation request format and required parameters.
443	ERR_VERIFY_NOT_MATCHED	Request id and code are not matched.	The verification code does not match the requested verification record.	Verify the code entered by the user and try again.
444	ERR_VERIFY_SMS_CANCELLED	Verify SMS cancelled.	The verification request has already been cancelled.	Generate a new verification request if verification is still required.
445	ERR_INVALID_CALLBACK_METHOD	You can choose callback_method between POST or GET method.	The callback HTTP method is invalid.	Use a supported callback method (e.g., POST).
446	ERR_OFTEN_WRONG_APIKEY	This api_key often wrong request. Please wait for a while or contact admin.	Multiple invalid authentication attempts have been detected.	Verify your API credentials before retrying. Contact Support if your account has been temporarily restricted via help@movider.co
448	ERR_COUNTRY_SPECIFIC_CONDITION	This country-specific service condition.	Required country-specific conditions have not been satisfied.	Review the destination country's requirements (e.g., Sender Registration, template approval, URL whitelist).
451	ERR_TAG_EXIST	This tag exist.
452	ERR_TAG_TOO_LONG	Tag is too long 50 characters.
453	ERR_BALANCE_FORM	Balance form is invalid.	The balance request contains invalid parameters.	Verify the request format and required fields.
454	ERR_RESERVED_WORD_NOT_FOUND	Reserved word not found.
456	ERR_MEMBER_TRAIL	You are a trial member that can use the registered phone number only.	The account is using a trial plan that does not support this operation.	Upgrade your account to access this feature.
458	ERR_USE_VOICE	use_voice possible are Y or N
460	ERR_SENDER	Sender is invalid.	The sender name is invalid, missing, or not registered.	Verify the sender name format and ensure it is registered if required by the destination country.
461	ERR_DELIVERY_DATETIME_REQUIRED	Delivery datetime is required	A scheduled delivery time is required but was not provided.	Specify a valid delivery date and time.
462	ERR_DELIVERY_DATETIME_AFTER_CURRENT_DATETIME	Delivery datetime must be after current datetime	The scheduled delivery time is earlier than the current time.	Specify a future delivery date and time.
466	ERR_SMS_SCHEDULE_ID_INVALID	SMS schedule id is invalid	The Schedule ID is invalid.	Verify the Schedule ID before retrying.
467	ERR_SMS_SCHEDULE_NOT_FOUND	SMS schedule not found	The specified Schedule ID could not be found.	Verify the Schedule ID exists.
469	ERR_INVALID_API_KEY_SECRET	Invalid API key or secret	The API Key or API Secret is incorrect.	Verify both API credentials before retrying.
470	ERR_SMS_SCHEDULE_NOT_ALLOWED_CANCEL	SMS schedule delivery status not allowed to cancel	The scheduled SMS cannot be cancelled because its current status does not allow cancellation.	Verify the schedule status. Only pending or scheduled messages can be cancelled.
472	ERR_COUNTRY_UNAVAILABLE	Contact help@movider.co to send to your target country
485	ERR_RATE_LIMIT	Hit rate limit
486	ERR_SMS_OUTBOUND_URL_THSENDER	URL detected in the message for Thailand. Please register the URL template with the sender before use by contacts us (help@movider.co)
487	ERR_INVALID_TEMPLATE_TEXT	Text field template doesn't exist, Please contact contacts us (help@movider.co).
488	ERR_INVALID_CHANNEL_NAME	Cannot find channel name.
489	ERR_INVALID_TEMPLATE	Template was invalid.
490	ERR_MISSING_DYNAMIC_FIELDS	The request is missing required dynamic field values for the selected template.
491	ERR_WALLET_NOT_FOUND	Your wallet are not found.
492	ERR_TEMPLATE_NOT_FOUND	Your whatsapp template are not found.
493	ERR_TEMPORARILY_RESTRICTED_MESSAGE	Action temporarily restricted for security reasons.

Following properties:

• code integer: Error code
• name string: Error name
• description string: Readable error description
• possible_cause string (optional): Likely reason for the error, when available
• next_action string (optional): Suggested fix, when available

Code
{
  "error": {
    "code": 462,
    "name": "ERR_DELIVERY_DATETIME_AFTER_CURRENT_DATETIME",
    "description": "Delivery datetime must be after current datetime",
    "possible_cause": "The scheduled delivery time is earlier than the current time.",
    "next_action": "Specify a future delivery date and time."
  }
}