Platform API
Error Codes

Error Codes

This section 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,
    "message": string,
    "code": int
}

Error codes

The following table lists client/server errors that the 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 (MissingRequiredParameter)
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)

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

400
(bad request)

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

400
(bad request)

400109 (ExpiredPageToken)
The value of the token parameter for pagination has expired.

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)

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's appId parameter 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 (MissingSomeParameter)
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 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)

400800 (FreeQuotaExceeded)
The request cannot be completed because you have exceeded your free quota.

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.

500
(internal server error)

500920 (UnauthorizedOperation)
The request is not authorized because you are not allowed to perform this operation.

503
(service unavailable)

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