iOS
Error Codes

Error Codes

The iOS SDK has two types of error codes:

  • Client error codes: these errors are usually caused by something the client app side did, such as incorrect or invalid parameter, or sending a request when disconnected.
  • Server error codes: these errors are usually caused by a SendBird server side issue.

Client error codes

The following errors that are defined by SBDErrorCode in SBDTypes.h are six-digit integers beginning with 800.

ErrorCodeDescription

SBDErrorInvalidInitialization

800100

The initialization of the SendBird instance failed because the assigned value to the appId parameter of the initializing method is not valid.

SBDErrorConnectionRequired

800101

The request from a client app failed because the device is not connected to the server.

SBDErrorConnectionCancelled

800102

The connection is canceled or the disconnecting method is called while the SendBird instance is trying to connect to the server via the connecting method.

SBDErrorInvalidParameter

800110

The parameter of the method specifies an invalid value.

SBDErrorNetworkError

800120

The connection failed due to the unstable network or an unexpected error in the SDK network library.

SBDErrorNetworkRoutingError

800121

The request routing to the server failed.

SBDErrorMalformedData

800130

The data format of the server response is invalid.

SBDErrorMalformedErrorData

800140

The data format of the error message is invalid due to the problem with the request.

SBDErrorWrongChannelType

800150

The specified channel type in the request is invalid.

SBDErrorMarkAsReadRateLimitExceeded

800160

The interval between the successive mark-messages-as-read requests is less than a second.

SBDErrorQueryInProgress

800170

A retrieval request is arriving while the server is still processing the previous retrieval request for channels, messages, or users, and in preparation to send the response.

SBDErrorAckTimeout

800180

The server fails to send a response for the request in 10 seconds (timed-out).

SBDErrorLoginTimeout

800190

The server fails to send a response for the SendBird instance's login request in 10 seconds (timed-out).

SBDErrorWebSocketConnectionClosed

800200

The request failed due to being submitted while disconnected from the server.

SBDErrorWebSocketConnectionFailed

800210

The websocket connection to the server failed to establish.

SBDErrorRequestFailed

800220

The server fails to process the request due to an internal reason.

SBDErrorFileUploadCancelFailed

800230

The server fails to process the file-upload cancellation request due to an internal reason.

SBDErrorFileUploadCancelled

800240

The server fails to process the file-upload due to the cancellation.

SBDErrorFileUploadTimeout

800250

The server fails to complete the file-upload request in the allowed period (timed-out).


Server error codes

The following errors are six-digit integers beginning with 400, 500, and 900.

CodeDescription

400100
(bad request)

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

400101
(bad request)

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

400102
(bad request)

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

400103
(bad request)

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

400104
(bad request)

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

400105
(bad request)

MissingRequiredParameter
The request is missing one or more required parameters.

400106
(bad request)

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

400107
(bad request)

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

400108
(bad request)

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

400109
(bad request)

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

400110
(bad request)

ParameterValueLengthExceeded
The length of the parameter value is too long.

400111
(bad request)

InvalidValue
The request specifies an invalid value.

400112
(bad request)

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

400151
(bad request)

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

400201
(bad request)

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

400202
(bad request)

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

400203
(bad request)

TooManyItemsInParameter
The parameter specifies more items than allowed.

400300
(bad request)

DeactivatedUserNotAccessible
The request cannot retrieve the deactivated user data.

400301
(bad request)

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

400302
(bad request)

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

400303
(bad request)

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

400304
(bad request)

ApplicationNotFound
The application identified with the request's appId parameter cannot be found.

400305
(bad request)

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

400306
(bad request)

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

400307
(bad request)

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

400401
(bad request)

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

400402
(bad request)

MissingSomeParameter
The request is missing one or more necessary parameters.

400403
(bad request)

InvalidJsonRequestBody
The request body is an invalid JSON.

400404
(bad request)

InvalidRequestURL
The request specifies an invalid URL that cannot be accessed.

400500
(bad request)

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

400501
(bad request)

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

400700
(bad request)

BlockedUser.SendMessageNotAllowed
The request cannot be completed because the blocked user is trying to send a message to the blocking user.

400701
(bad request)

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

400702
(bad request)

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

400750
(bad request)

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

400751
(bad request)

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

400800
(bad request)

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

500601
(internal server error)

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

500602
(internal server error)

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

500901
(internal server error)

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

500910
(too many request)

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

500920
(internal server error)

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

503
(service unavailable)

ServiceUnavailable
The request failed due to a temporary failure of the server. Please retry the request.

900010
(request failed)

UserLoginRequired
The request failed because the user is not logged in to the server.

900020
(request failed)

UserNotMember
The request failed because the user is not a member of the channel.

900021
(request failed)

UserDeactivated
The request failed becuase the user is deactivated in the service.

900022
(request failed)

UserNotOwnerOfMessage
The request failed because the user has no permission to edit the other user's message.

900023
(request failed)

PendingUserSendMessageNotAllowed
The request failed because the user is trying to send the messages in the channel of which they are not the member.

900025
(request failed)

InvalidMentionForMessage
The specified mention type in the request is invaild.

900026
(request failed)

InvalidPushOptionForMessage
The specified push option in the request is invalid.

900027
(request failed)

TooManyMetaKeyForMessage
The request failed because it specifies more meta data keys for the message than allowed.

900028
(request failed)

TooManyMetaValueForMessage
The request failed because it specifies more meta data values for the message than allowed.

900029
(request failed)

InvalidMetaArrayForMessage
The request failed because it specifies an invalid value in the meta data for the message.

900030
(request failed)

GuestNotAllowed
The request failed because the guest is not allowed to perform this operation.

900040
(request failed)

MutedUserInApplicationSendMessageNotAllowed
The request failed because the user is muted in the application and is not allowed to send the message.

900041
(request failed)

MutedUserInChannelSendMessageNotAllowed
The request failed because the user is muted in the channel and is not allowed to send the message.

900050
(request failed)

ChannelFrozen
The request failed because the channel is frozen and no one can send the message to the channel.

900060
(request failed)

ProfanityMessageBlocked
The request failed because it specifies the message containing a profanity word.

900061
(request failed)

BannedURLsBlocked
The request failed because message it specifies the message containing a URL that is not allowed.

900065
(request failed)

RestrictedDomainBlocked
The request failed because it comes from the domain that is not allowed.

900066
(request failed)

ModeratedFileBlocked
The request failed because it contains the file violating at least one of the content management policies.

900070
(request failed)

EnterDeletedChannel
The request failed because the user is trying to enter a deleted channel.

900080
(request failed)

BlockedUserReceiveMessageNotAllowed
The request failed because the blocking user is trying to send the message to the blocked user in a 1-on-1 distinct channel.

900081
(request failed)

DeactivatedUserReceiveMessageNotAllowed
The request failed because the user is trying to send the message to the deactivated user in a 1-on-1 distinct channel.

900090
(request failed)

WrongChannelType
The request failed because it specifies a wrong channel type.

900100
(request failed)

BannedUserSendMessageNotAllowed
The request failed because the user is banned from the channel and is not allowed to send the message.

900200
(request failed)

TooManyMessages
The number of the sent messages exceeds the allowed amount.

900300
(request failed)

MessageNotFound
The request failed because the message to edit cannot be retrieved.

900400
(request failed)

TooManyParticipants
The number of the channel's participants exceeds the allowed amount.

900500
(request failed)

ChannelNotFound
The request failed because there is no channel to perform this operation.