Chat SDKs iOS v3
Chat SDKs iOS
Chat SDKs
iOS
Version 3
Sendbird Chat SDK v3 for iOS is no longer supported as a new version is released. Check out our latest Chat SDK v4

Error codes

Copy link

Sendbird Chat SDK for iOS 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

Copy link

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 SBDMain instance failed because the assigned value to the appId parameter of the initializing method isn't valid.

SBDErrorConnectionRequired

800101

The request from a client app failed because the device isn't connected to the server.

SBDErrorConnectionCanceled

800102

The connection is canceled or the disconnecting method is called while the SBDMain 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 Chat 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 failed to send a response for the request in 10 seconds (timed-out).

SBDErrorLoginTimeout

800190

The server failed to send a response for the SBDMain 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 failed to process the request due to an internal reason.

SBDErrorFileUploadCancelFailed

800230

The request to cancel file upload failed due to an unexpected error.

SBDErrorFileUploadCanceled

800240

The file upload request is canceled.

SBDErrorFileUploadTimeout

800250

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


Server error codes

Copy link

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)

MissingRequiredParameters
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.

400108
(bad request)

UnauthorizedRequest
The request isn't authorized and can't access the requested resource.

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.

400113
(bad request)

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

400114
(bad request)

InvalidURLOfResource
The resource identified with the URL in the request can't be found.

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 can't be found.

400202
(bad request)

ResourceAlreadyExists
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 can't retrieve the deactivated user data.

400301
(bad request)

UserNotFound
The user identified with the request's userId parameter can't be found because either the user doesn't exist or has been deleted.

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 can't be found.

400305
(bad request)

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

400306
(bad request)

PaidQuotaExceeded
The request can't be completed because you have exceeded your paid quota.

400307
(bad request)

DomainNotAllowed
The request can't 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)

MissingSomeParameters
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 HTTP request URL that can't 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 can't be completed due to one of the following reasons: The sender is blocked by the recipient or has been deactivated, the message is longer than the maximum message length, or the message contains texts or URLs blocked by application settings or filters.

400701
(bad request)

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

400702
(bad request)

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

400750
(bad request)

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

400751
(bad request)

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

400920
(bad request)

Unacceptable
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.
ReadOnlyMode
When the application is in read-only mode, can't complete API requests except for GET.
NotAccessible
The request DELETE fails when the corresponding message has a child message.

400930
(bad request)

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

403100
(forbidden)

ApplicationNotAvailable
The application identified with the request isn't available.

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 can't be completed because you have exceeded your rate limits.

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 isn't logged in to the server.

900020
(request failed)

UserNotMember
The request failed because the user isn't a member of the channel.

900021
(request failed)

UserDeactivated
The request failed because 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 invalid.

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 isn't allowed to perform this operation.

900040
(request failed)

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

900041
(request failed)

MutedUserInChannelSendMessageNotAllowed
The request failed because the user is muted in the channel and isn't 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 isn't allowed.

900065
(request failed)

RestrictedDomainBlocked
The request failed because it comes from the domain that isn't 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-to-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-to-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 isn't 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 can't 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.