All Products
Search
Document Center

Chat App Message Service:Viber API error codes

Last Updated:Jun 17, 2026

The following table lists the error codes that Viber API requests may return.

Error code

Description

SRVC_INTERNAL_FAILURE

An internal server error occurred.

SRVC_BAD_SERVICE_ID

The ServiceID has not been used for over a year or it was recently created and has not yet been uploaded to the server.

SRVC_BAD_DATA

An error occurred in the request structure. This could be due to missing commas, parentheses, or text exceeding 1,000 characters.

SRVC_BAD_MESSAGE_TYPE

The message type is incorrect or unsupported.

SRVC_BAD_PARAMETERS

One or more required parameters were not specified.

SRVC_TIMEOUT

The server on the Viber side timed out.

SRVC_USER_BLOCKED

The user has blocked this ID or has disabled business messages on their device.

SRVC_NOT_VIBER_USER

The target number is not registered as a Viber user.

SRVC_NO_SUITABLE_DEVICE

The Viber version does not support Viber business messages (requires version 5.3 or higher).

SRVC_UNAUTHORIZED_IP

The request was sent from an IP address not whitelisted for this ID, or the ID used in the request does not belong to the partner.

SRVC_NOT_PERMITTED

A billing error occurred. Please contact your account manager.

SRVC_BAD_LABEL

The value of the "label" parameter in the request is missing or incorrect.

SRVC_INVALID_TTL

TTL is less than 30 seconds or exceeds 1,209,600 seconds.

SRVC_WAIT_FOR_USER_RESPONSE

The session message limit of 5 messages has been exceeded.

SRVC_FILE_NOT_PERMITTED

The file format is not supported for this feature.

SRVC_BAD_FILE_NAME_LENGTH

The file name length exceeds 25 characters.

SRVC_BAD_THUMBNAIL

The thumbnail URL exceeds 1,000 characters.

SRVC_BAD_FILE_SIZE

The video file size exceeds 200 MB.

SRVC_BAD_DURATION

The video duration exceeds 600 seconds.