Error Codes

This section contains the following information:

  • Error response
  • 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)
{
  "error": boolean,
  "message": string,
  "code": int
}

Error codes

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

HTTP code Code Description
400 400100
(UnexpectedParameterType)
The request specifies one or more parameters in an unexpected data type. The data type of the parameters should be string.
400 400101
(UnexpectedParameterType)
The request specifies one or more parameters in an unexpected data type. The data type of the parameters should be number.
400 400102
(UnexpectedParameterType)
The request specifies one or more parameters in an unexpected data type. The data type of the parameters should be list.
400 400103
(UnexpectedParameterType)
The request specifies one or more parameters in an unexpected data type. The data type of the parameters should be JSON.
400 400104
(UnexpectedParameterType)
The request specifies one or more parameters in an unexpected data type. The data type of the parameters should be boolean.
400 400105
(MissingRequiredParameter)
The request is missing one or more required parameters.
400 400106
(NegativeNumberNotAllowed)
The parameter specifies an invalid negative number. Its value should be a positive number.
400 400107
(PositiveNumberNotAllowed)
The parameter specifies an invalid positive number. Its value should be a negative number.
400 400108
(UnauthorizedRequest)
The request is not authorized and cannot access the requested resource.
400 400109
(ExpiredPageToken)
The value of the token parameter for pagination has expired.
400 400110
(ParameterValueLengthExceeded)
The length of the parameter value is too long.
400 400111
(InvalidValue)
The request specifies an invalid value.
400 400112
(IncompatibleValues)
The two parameters of the request, which should have unique values, specify the same value.
400 400151
(NotAllowedCharacter)
The request specifies an illegal value containing special character, empty string, or white space.
400 400201
(ResourceNotFound)
The resource identified with the request's resourceId parameter cannot be found.
400 400202
(ResouceAlreadyExists)
The resource identified with the request's resourceId parameter already exists.
400 400203
(TooManyItemsInParameter)
The parameter specifies more items than allowed.
400 400300
(DeactivatedUserNotAccessible)
The request cannot retrieve the deactivated user data.
400 400301
(UserNotFound)
The user identified with the request's userId parameter cannot be found.
400 400302
(InvalidAccessToken)
The access token provided for the request specifies an invalid value.
400 400303
(InvalidSessionKeyValue)
The session key provided for the request specifies an invalid value.
400 400304
(ApplicationNotFound)
The application identified with the request's appId parameter cannot be found.
400 400305
(UserIdLengthExceeded)
The length of the userId parameter value is too long.
400 400306
(PaidQuotaExceeded)
The request cannot be completed because you have exceeded your paid quota.
400 400307
(DomainNotAllowed)
The request cannot be completed because it came from the restricted domain.
400 400401
(InvalidApiToken)
The API token provided for the request specifies an invalid value.
400 400402
(MissingSomeParameter)
The request is missing one or more necessary parameters.
400 400403
(InvalidJsonRequestBody)
The request body is an invalid JSON.
400 400404
(InvalidRequestURL)
The request specifies an invalid URL that cannot be accessed.
400 400500
(TooManyUserWebsocketConnections)
The number of the user's websocket connections exceeds the allowed amount.
400 400501
(TooManyApplicationWebsocketConnections)
The number of the application's websocket connections exceeds the allowed amount.
400 400700
(BlockedUser.SendNotAllowed)
The request cannot be completed because the blocked user is trying to send a message to the blocking user.
400 400701
(BlockedUser.InvitedNotAllowed)
The request cannot be completed because the blocking user is trying to invite the blocked user to a channel.
400 400702
(BlockedUser.InviteNotAllowed)
The request cannot be completed because the blocked user is trying to invite the blocking user to a channel.
400 400750
(BannedUser.EnterChannelNotAllowed)
The request cannot be completed because the user is trying to enter a banned channel.
400 400751
(BannedUser.EnterCustomChannelNotAllowed)
The request cannot be completed because the user is trying to enter a banned custom type channel.
400 400800
(FreeQuotaExceeded)
The request cannot be completed because you have exceeded your free quota.
429 500910
(RateLimitExceeded)
The request cannot be completed because you have exceeded your rate limits.
500 500601
(InternalError.PushTokenNotRegistered)
The server encounters an error while trying to register the user's push token. Please retry the request.
500 500602
(InternalError.PushTokenNotUnregistered)
The server encounters an error while trying to unregister the user's push token. Please retry the request.
500 500901
(InternalError)
The server encounters an unexpected exception while trying to process the request. Please retry the request.
500 500920
(UnauthorizedOperation)
The request is not authorized because you are not allowed to perform this operation.
503 N/A
(ServiceUnavailable)
The request failed due to a temporary failure of the server. Please retry the request.