Error codes

This page contains the following information:

  • Error response: a JSON format which is used for Sendbird server to send an error response to a client's request.
  • Error codes: these errors are usually caused by something the client did and an Sendbird server-side issue. These errors are accompanied by a 400/500-series HTTP response code.

Error response

All errors return a 400 or 500 HTTP response. The details of each error are included in the message field.

Response (JSON)
Light Color Skin
Copy
{
    "error": boolean,
    "code": int,
    "message": string
}

Error codes

The following table lists client/server errors that Chat Platform API returns in response to calls.

HTTP status codeError detail

400
(bad request)

400100 (UnexpectedParameterType)
The request specifies one or more parameters in an unexpected data type. The data type of the parameters should be string.

400
(bad request)

400101 (UnexpectedParameterType)
The request specifies one or more parameters in an unexpected data type. The data type of the parameters should be number.

400
(bad request)

400102 (UnexpectedParameterType)
The request specifies one or more parameters in an unexpected data type. The data type of the parameters should be list.

400
(bad request)

400103 (UnexpectedParameterType)
The request specifies one or more parameters in an unexpected data type. The data type of the parameters should be JSON.

400
(bad request)

400104 (UnexpectedParameterType)
The request specifies one or more parameters in an unexpected data type. The data type of the parameters should be boolean.

400
(bad request)

400105 (MissingRequiredParameters)
The request is missing one or more required parameters.

400
(bad request)

400106 (NegativeNumberNotAllowed)
The parameter specifies an invalid negative number. Its value should be a positive number.

400
(bad request)

400108 (UnauthorizedRequest)
The request is not authorized and cannot access the requested resource.

400
(bad request)

400110 (ParameterValueLengthExceeded)
The length of the parameter value is too long.

400
(bad request)

400111 (InvalidValue)
The request specifies an invalid value.

400
(bad request)

400112 (IncompatibleValues)
The two parameters of the request, which should have unique values, specify the same value.

400
(bad request)

400113 (ParameterValueOutOfRange)
The request specifies one or more parameters which are outside the allowed value range.

400
(bad request)

400114 (InvalidURLOfResource)
The resource identified with the URL in the request cannot be found.

400
(bad request)

400151 (NotAllowedCharacter)
The request specifies an illegal value containing special character, empty string, or white space.

400
(bad request)

400201 (ResourceNotFound)
The resource identified with the request's resourceId parameter cannot be found.

400
(bad request)

400202 (ResouceAlreadyExists)
The resource identified with the request's resourceId parameter already exists.

400
(bad request)

400203 (TooManyItemsInParameter)
The parameter specifies more items than allowed.

400
(bad request)

400300 (DeactivatedUserNotAccessible)
The request cannot retrieve the deactivated user data.

400
(bad request)

400301 (UserNotFound)
The user identified with the request's userId parameter cannot be found.

400
(bad request)

400302 (InvalidAccessToken)
The access token provided for the request specifies an invalid value.

400
(bad request)

400303 (InvalidSessionKeyValue)
The session key provided for the request specifies an invalid value.

400
(bad request)

400304 (ApplicationNotFound)
The application identified with the request cannot be found.

400
(bad request)

400305 (UserIdLengthExceeded)
The length of the userId parameter value is too long.

400
(bad request)

400306 (PaidQuotaExceeded)
The request cannot be completed because you have exceeded your paid quota.

400
(bad request)

400307 (DomainNotAllowed)
The request cannot be completed because it came from the restricted domain.

400
(bad request)

400401 (InvalidApiToken)
The API token provided for the request specifies an invalid value.

400
(bad request)

400402 (MissingSomeParameters)
The request is missing one or more necessary parameters.

400
(bad request)

400403 (InvalidJsonRequestBody)
The request body is an invalid JSON.

400
(bad request)

400404 (InvalidRequestURL)
The request specifies an invalid HTTP request URL that cannot be accessed.

400
(bad request)

400500 (TooManyUserWebsocketConnections)
The number of the user's websocket connections exceeds the allowed amount.

400
(bad request)

400501 (TooManyApplicationWebsocketConnections)
The number of the application's websocket connections exceeds the allowed amount.

400
(bad request)

400700 (BlockedUser.SendNotAllowed)
The request cannot be completed because the blocked user is trying to send a message to the blocking user.

400
(bad request)

400701 (BlockedUser.InvitedNotAllowed)
The request cannot be completed because the blocking user is trying to invite the blocked user to a channel.

400
(bad request)

400702 (BlockedUser.InviteNotAllowed)
The request cannot be completed because the blocked user is trying to invite the blocking user to a channel.

400
(bad request)

400750 (BannedUser.EnterChannelNotAllowed)
The request cannot be completed because the user is trying to enter a banned channel.

400
(bad request)

400751 (BannedUser.EnterCustomChannelNotAllowed)
The request cannot be completed because the user is trying to enter a banned custom type channel.

400
(bad request)

400920 (InvalidCombinationOfParameterValues)
The request failed because the combination of parameter values is invalid. Even if each parameter value is valid, a combination of parameter values becomes invalid when it doesn't follow specific conditions.

400
(bad request)

400930 (InvalidEndpoint)
The request failed because it is sent to an invalid endpoint that no longer exists.

403
(forbidden)

403100 (ApplicationNotAvailable)
The application identified with the request is not available.

429
(too many request)

500910 (RateLimitExceeded)
The request cannot be completed because you have exceeded your rate limits.

500
(internal server error)

500601 (InternalError.PushTokenNotRegistered)
The server encounters an error while trying to register the user's push token. Please retry the request.

500
(internal server error)

500602 (InternalError.PushTokenNotUnregistered)
The server encounters an error while trying to unregister the user's push token. Please retry the request.

500
(internal server error)

500901 (InternalError)
The server encounters an unexpected exception while trying to process the request. Please retry the request.

503
(service unavailable)

N/A (ServiceUnavailable)
The request failed due to a temporary failure of the server. Please retry the request.