SDK Error Codes

Use these tables to determine what your SDK error codes and responses mean.

18 min read

Error Handling

When you develop for EOS you might see errors reported by different interfaces. The table below has some common error codes, their cause and their solution:-

Numeric Error CodeError Code/String CodeError MessageDocumentationCauseSolution(s)
300errors.com.epicgames.common.policy_missing_actionFailed to unlock achievementsClient CredentialsClient Policy missing permissionAdd missing policy to Client Policy on the Developer Portal in Product Settings -> Clients tab.
401errors.com.epicgames.eos.auth.client_not_foundClient not found: [id]Client not configuredConfigure Client in Developer Portal Clients.
1003errors.com.epicgames.forbidden(ECOM Context) Not allowed to access resource belonging to account xxxxxxxxxxauth user doesn't match the userid being queried
1011errors.com.epicgames.common.oauth.invalid_clientInvalid Client: 'XXXXXXXXXXXXXX'AgreementsUnaccepted agreement/Wrong client IDThis error occurs when the new agreement hasn't been accepted - the Organization owner would need to accept this on the Developer Portal. If this has been done - check if using the correct Client ID/Secret and make sure they are the EOS SDK credentials.
1012errors.com.epicgames.bad_requestThe client is not configured correctly. Please make sure it is associated with an Application.Check that EAS setup has been completedClient not configured with Application. Likely cause: Org owner has not accepted EAS agreement and proceeded to this point, or linked the client to the EAS config.
1012errors.com.epicgames.common.oauth.invalid_grantinvalid_grantAuth InterfaceWrong auth type (email/password)
1012errors.com.epicgames.oauth.account_forbiddenAccount cannot access deployment 'XXXXXXXXXX'Product ManagementPrivate sandboxThe sandbox should be public for EGS partners.
1012errors.com.epicgames.server_errorError listing oauth scopesInternal Epic error
1023errors.com.epicgames.common.missing_permissionSorry your login does not possess the permissions 'egp:account:token:otherSessionsForAccountClientService DELETE' needed to perform the requested operationWhat's NewNew clients created after 1.5 SDK didn't include this permission by default. This happens when older SDKS (1.4 and earlier) are using 1.5 clients.For 1.4 or earlier, add permission. For 1.5 or later, a fix is underway on Epic's side.
1023errors.com.epicgames.common.missing_permissionSorry your login does not posses the permissions 'egp:account:public:account READ' needed to perform the requested operationWhat's NewNew clients created after 1.5 SDK didn't include this permission by default. This happens when older SDKS (1.4 and earlier) are using 1.5 clients.tFor 1.4 or earlier, add permission. For 1.5 or later, a fix is underway on Epic's side.
1040errors.com.epicgames.validation.validation_failedValidation Failed. Invalid Fields were [LineOffers]Offers (DLC/Add-Ons) not found or validEither the offers setup for enumeration and validation were set to not discoverable or do not exist under the product in question. Coordinate with your Service Delivery manager to verify they exist under the correct product and are configured correctly.
18603errors.com.epicgames.account.external_auth_validate_failedFailed to verify token for authType: steam_encrypted_appticket and sandboxId: XXX, error: Sandbox credentials not found for sandboxId: xxxxxxxxxxx identityProvider: steamIdentity Provider ManagementSteam has not been configured as an identity provider and added to the sandboxMake sure the Identity provider is configured for the product with the valid encryption key, and added to the actual Sandbox in Developer Portal Environments -> Sandbox -> Identity Providers -> Steam.
18603errors.com.epicgames.account.external_auth_validate_failedThe Encryption Key entered in the dev portal does not match SteamworksEnsure that the Steam Encryption Key in your Steamworks dashboard matches with the one added in EOS Dev Portal. Check that the change has been published in Steamworks as there is a case of inputting/generating a new key and not publishing which means the keys are misaligned.
46022errors.com.epicgames.ecommerce.integration.client_restrictedYou’re not allowed to access this resource, please contact the identity support team.Epic Account ServicesOmitted Deployment ID from token requestMake sure deployment_id=foo is included in the POST https://api.epicgames.dev/epic/oauth/v1/token request.
58005errors.com.epicgames.oauth.scope_consent_requiredThe user has not consented to required scopes.Developer PortalMismatch between SDK request and Client featuresSDK needs to be initialized with the same scopes as EOS Client on Dev Portal. Fix client code and/or Dev Portal to match.
110016errors.com.epicgames.eos.auth.user_not_foundEOS User Identity not foundConnect InterfaceUser account has not been registered with EOSRegister user with EOS.

Error Results

Error codes from EOS SDK functions use the type EOS_EResult. This type includes both common error values and errors specific to a single interface. Common errors take the form EOS_<ErrorCode>, while interface-specific error codes appear as EOS_<Interface>_<ErrorCode>. For example: EOS_Initialize returns an EOS_EResult to indicate success or failure. The value will be EOS_Success if the SDK has been initialized successfully, otherwise, the value will indicate an error, such as EOS_AlreadyConfigured.

Numeric CodeCode ReturnCause/Reason
0EOS_Success/** Successful result. no further error processing needed */
1EOS_NoConnection/** Failed due to no connection */
2EOS_InvalidCredentials/** Failed login due to invalid credentials */
3EOS_InvalidUser/** Failed due to invalid or missing user */
4EOS_InvalidAuth/** Failed due to invalid or missing authentication token for user e.g. not logged in */
5EOS_AccessDenied/** Failed due to invalid access */
6EOS_MissingPermissions/** If the client does not possess the permission required */
7EOS_Token_Not_Account/** If the token provided does not represent an account */
8EOS_TooManyRequests/** Throttled due to too many requests */
9EOS_AlreadyPending/** Async request was already pending */
10EOS_InvalidParameters/** Invalid parameters specified for request */
11EOS_InvalidRequest/** Invalid request */
12EOS_UnrecognizedResponse/** Failed due to unable to parse or recognize a backend response */
13EOS_IncompatibleVersion/** Incompatible client for backend version */
14EOS_NotConfigured/** Not configured correctly for use */
15EOS_AlreadyConfigured/** Already configured for use. */
16EOS_NotImplemented/** Feature not available on this implementation */
17EOS_Canceled/** Operation was canceled likely by user */
18EOS_NotFound/** The requested information was not found */
19EOS_OperationWillRetry/** An error occurred during an asynchronous operation, and it will be retried. Callbacks receiving this result will be called again in the future. */
20EOS_NoChange/** The request had no effect */
21EOS_VersionMismatch/** The request attempted to use multiple or inconsistent API versions */
22EOS_LimitExceeded/** A maximum limit was exceeded on the client, different from `EOS_TooManyRequests */
23EOS_Disabled/** Feature or client ID performing the operation has been disabled. */
24EOS_DuplicateNotAllowed/** Duplicate entry not allowed */
25EOS_MissingParameters_DEPRECATED/** Required parameters are missing. DEPRECATED: This error is no longer used. */
26EOS_InvalidSandboxId/** Sandbox ID is invalid */
27EOS_TimedOut/** Request timed out */
28EOS_PartialResult/** A query returned some but not all of the requested results. */
29EOS_Missing_Role/** Client is missing the whitelisted role */
30EOS_Missing_Feature/** Client is missing the whitelisted feature */
31EOS_Invalid_Sandbox/** The sandbox given to the backend is invalid */
32EOS_Invalid_Deployment/** The deployment given to the backend is invalid */
33EOS_Invalid_Product/** The product ID specified to the backend is invalid */
34EOS_Invalid_ProductUserID/** The product user ID specified to the backend is invalid */
35EOS_ServiceFailure/** There was a failure with the backend service */
36EOS_CacheDirectoryMissing/** Cache directory is not set in platform options. */
37EOS_CacheDirectoryInvalid/** Cache directory is not accessible. */
38EOS_InvalidState/** The request failed because resource was in an invalid state */
39EOS_RequestInProgress/** Request is in progress */
1001EOS_Auth_AccountLocked/** Account locked due to login failures */
1002EOS_Auth_AccountLockedForUpdate/** Account locked by update operation. */
1003EOS_Auth_InvalidRefreshToken/** Refresh token used was invalid */
1004EOS_Auth_InvalidToken/** Invalid access token, typically when switching between backend environments */
1005EOS_Auth_AuthenticationFailure/** Invalid bearer token */
1006EOS_Auth_InvalidPlatformToken/** Invalid platform token */
1007EOS_Auth_WrongAccount/** Auth parameters are not associated with this account */
1008EOS_Auth_WrongClient/** Auth parameters are not associated with this client */
1009EOS_Auth_FullAccountRequired/** Full account is required */
1010EOS_Auth_HeadlessAccountRequired/** Headless account is required */
1011EOS_Auth_PasswordResetRequired/** Password reset is required */
1012EOS_Auth_PasswordCannotBeReused/** Password was previously used and cannot be reused */
1013EOS_Auth_Expired/** Authorization code/exchange code has expired */
1014EOS_Auth_ScopeConsentRequired/** Consent has not been given by the user */
1015EOS_Auth_ApplicationNotFound/** The application has no profile on the backend */
1016EOS_Auth_ScopeNotFound/** The requested consent wasn't found on the backend */
1017EOS_Auth_AccountFeatureRestricted/** This account has been denied access to login */
1020EOS_Auth_PinGrantCode/** Pin grant code initiated */
1021EOS_Auth_PinGrantExpired/** Pin grant code attempt expired */
1022EOS_Auth_PinGrantPending/** Pin grant code attempt pending */
1030EOS_Auth_ExternalAuthNotLinked/** External auth source did not yield an account */
1032EOS_Auth_ExternalAuthRevoked/** External auth access revoked */
1033EOS_Auth_ExternalAuthInvalid/** External auth token cannot be interpreted */
1034EOS_Auth_ExternalAuthRestricted/** External auth cannot be linked to his account due to restrictions */
1035EOS_Auth_ExternalAuthCannotLogin/** External auth cannot be used for login */
1036EOS_Auth_ExternalAuthExpired/** External auth is expired */
1037EOS_Auth_ExternalAuthIsLastLoginType/** External auth cannot be removed since it's the last possible way to login */
1040EOS_Auth_ExchangeCodeNotFound/** Exchange code not found */
1041EOS_Auth_OriginatingExchangeCodeSessionExpired/** Originating exchange code session has expired */
1050EOS_Auth_PersistentAuth_AccountNotActive/** The account has been disabled and cannot be used for authentication */
1060EOS_Auth_MFARequired/** MFA challenge required */
1070EOS_Auth_ParentalControls/** Parental locks are in place */
1080EOS_Auth_NoRealId/** Korea real ID association required but missing */
2000EOS_Friends_InviteAwaitingAcceptance/** An outgoing friend invitation is awaiting acceptance; sending another invite to the same user is erroneous */
2001EOS_Friends_NoInvitation/** There is no friend invitation to accept/reject */
2003EOS_Friends_AlreadyFriends/** Users are already friends, so sending another invite is erroneous */
2004EOS_Friends_NotFriends/** Users are not friends, so deleting the friend is erroneous */
2005EOS_Friends_TargetUserTooManyInvites/** Remote user has too many invites to receive new invites */
2006EOS_Friends_LocalUserTooManyInvites/** Local user has too many invites to send new invites */
2007EOS_Friends_TargetUserFriendLimitExceeded/** Remote user has too many friends to make a new friendship */
2008EOS_Friends_LocalUserFriendLimitExceeded/** Local user has too many friends to make a new friendship */
3000EOS_Presence_DataInvalid/** Request data was null or invalid */
3001EOS_Presence_DataLengthInvalid/** Request contained too many or too few unique data items, or the request would overflow the maximum amount of data allowed */
3002EOS_Presence_DataKeyInvalid/** Request contained data with an invalid key */
3003EOS_Presence_DataKeyLengthInvalid/** Request contained data with a key too long or too short */
3004EOS_Presence_DataValueInvalid/** Request contained data with an invalid value */
3005EOS_Presence_DataValueLengthInvalid/** Request contained data with a value too long */
3006EOS_Presence_RichTextInvalid/** Request contained an invalid rich text string */
3007EOS_Presence_RichTextLengthInvalid/** Request contained a rich text string that was too long */
3008EOS_Presence_StatusInvalid/** Request contained an invalid status state */
4000EOS_Ecom_EntitlementStale/** The entitlement retrieved is stale, requery for updated information */
4001EOS_Ecom_CatalogOfferStale/** The offer retrieved is stale, requery for updated information */
4002EOS_Ecom_CatalogItemStale/** The item or associated structure retrieved is stale
4003EOS_Ecom_CatalogOfferPriceInvalid/** The one or more offers have an invalid price. This may be caused by the price setup. */
4004EOS_Ecom_CheckoutLoadError/** The checkout page failed to load */
5000EOS_Sessions_SessionInProgress/** Session is already in progress */
5001EOS_Sessions_TooManyPlayers/** Too many players to register with this session */
5002EOS_Sessions_NoPermission/** Client has no permissions to access this session */
5003EOS_Sessions_SessionAlreadyExists/** Session already exists in the system */
5004EOS_Sessions_InvalidLock/** Session lock required for operation */
5005EOS_Sessions_InvalidSession/** Invalid session reference */
5006EOS_Sessions_SandboxNotAllowed/** Sandbox ID associated with auth didn't match */
5007EOS_Sessions_InviteFailed/** Invite failed to send */
5008EOS_Sessions_InviteNotFound/** Invite was not found with the service */
5009EOS_Sessions_UpsertNotAllowed/** This client may not modify the session */
5010EOS_Sessions_AggregationFailed/** Backend nodes unavailable to process request */
5011EOS_Sessions_HostAtCapacity/** Individual backend node is as capacity */
5012EOS_Sessions_SandboxAtCapacity/** Sandbox on node is at capacity */
5013EOS_Sessions_SessionNotAnonymous/** An anonymous operation was attempted on a non anonymous session */
5014EOS_Sessions_OutOfSync/** Session is currently out of sync with the backend, data is saved locally but needs to sync with backend */
5015EOS_Sessions_TooManyInvites/** User has received too many invites */
5016EOS_Sessions_PresenceSessionExists/** Presence session already exists for the client */
5017EOS_Sessions_DeploymentAtCapacity/** Deployment on node is at capacity */
5018EOS_Sessions_NotAllowed/** Session operation not allowed */
6000EOS_PlayerDataStorage_FilenameInvalid/** Request filename was invalid */
6001EOS_PlayerDataStorage_FilenameLengthInvalid/** Request filename was too long */
6002EOS_PlayerDataStorage_FilenameInvalidChars/** Request filename contained invalid characters */
6003EOS_PlayerDataStorage_FileSizeTooLarge/** Request operation would grow file too large */
6004EOS_PlayerDataStorage_FileSizeInvalid/** Request file length is not valid */
6005EOS_PlayerDataStorage_FileHandleInvalid/** Request file handle is not valid */
6006EOS_PlayerDataStorage_DataInvalid/** Request data is invalid */
6007EOS_PlayerDataStorage_DataLengthInvalid/** Request data length was invalid */
6008EOS_PlayerDataStorage_StartIndexInvalid/** Request start index was invalid */
6009EOS_PlayerDataStorage_RequestInProgress/** Request is in progress */
6010EOS_PlayerDataStorage_UserThrottled/** User is marked as throttled which means he can't perform some operations because limits are exceeded. */
6011EOS_PlayerDataStorage_EncryptionKeyNotSet/** Encryption key is not set during SDK init. */
6012EOS_PlayerDataStorage_UserErrorFromDataCallback/** User data callback returned error EOS_PlayerDataStorage_EWriteResult::EOS_WR_FailRequest or EOS_PlayerDataStorage_EReadResult::EOS_RR_FailRequest */
6013EOS_PlayerDataStorage_FileHeaderHasNewerVersion/** User is trying to read a file that has a header from a newer version of SDK. Game/SDK needs to be updated */
6014EOS_PlayerDataStorage_FileCorrupted/** The file is corrupted. In some cases, retrying can fix the issue */
7000EOS_Connect_ExternalTokenValidationFailed/** `EOS Auth service deemed the external token invalid */
7001EOS_Connect_UserAlreadyExists/** `EOS Auth user already exists */
7002EOS_Connect_AuthExpired/** `EOS Auth expired */
7003EOS_Connect_InvalidToken/** `EOS Auth invalid token */
7004EOS_Connect_UnsupportedTokenType/** `EOS Auth doesn't support this token type */
7005EOS_Connect_LinkAccountFailed/** `EOS Auth Account link failure */
7006EOS_Connect_ExternalServiceUnavailable/** `EOS Auth External service for validation was unavailable */
7007EOS_Connect_ExternalServiceConfigurationFailure/** `EOS Auth External Service configuration failure with Dev Portal */
7008EOS_Connect_LinkAccountFailedMissingNintendoIdAccount_DEPRECATED/** `EOS Auth Account link failure. Tried to link Nintendo Network Service Account without first linking Nintendo Account. DEPRECATED: The requirement has been removed and this error is no longer used. */
8000EOS_UI_SocialOverlayLoadError/** The social overlay page failed to load */
9000EOS_Lobby_NotOwner/** Client has no permissions to modify this lobby */
9001EOS_Lobby_InvalidLock/** Lobby lock required for operation */
9002EOS_Lobby_LobbyAlreadyExists/** Lobby already exists in the system */
9003EOS_Lobby_SessionInProgress/** Lobby is already in progress */
9004EOS_Lobby_TooManyPlayers/** Too many players to register with this lobby */
9005EOS_Lobby_NoPermission/** Client has no permissions to access this lobby */
9006EOS_Lobby_InvalidSession/** Invalid lobby session reference */
9007EOS_Lobby_SandboxNotAllowed/** Sandbox ID associated with auth didn't match */
9008EOS_Lobby_InviteFailed/** Invite failed to send */
9009EOS_Lobby_InviteNotFound/** Invite was not found with the service */
9010EOS_Lobby_UpsertNotAllowed/** This client may not modify the lobby */
9011EOS_Lobby_AggregationFailed/** Backend nodes unavailable to process request */
9012EOS_Lobby_HostAtCapacity/** Individual backend node is as capacity */
9013EOS_Lobby_SandboxAtCapacity/** Sandbox on node is at capacity */
9014EOS_Lobby_TooManyInvites/** User has received too many invites */
9015EOS_Lobby_DeploymentAtCapacity/** Deployment on node is at capacity */
9016EOS_Lobby_NotAllowed/** Lobby operation not allowed */
9017EOS_Lobby_MemberUpdateOnly/** While restoring a lost connection lobby ownership changed and only local member data was updated */
9018EOS_Lobby_PresenceLobbyExists/** Presence lobby already exists for the client */
10000EOS_TitleStorage_UserErrorFromDataCallback/** User callback that receives data from storage returned error. */
10001EOS_TitleStorage_EncryptionKeyNotSet/** User forgot to set Encryption key during platform init. Title Storage can't work without it. */
10002EOS_TitleStorage_FileCorrupted/** Downloaded file is corrupted. */
10003EOS_TitleStorage_FileHeaderHasNewerVersion/** Downloaded file's format is newer than client SDK version. */
11000EOS_Mods_ModSdkProcessIsAlreadyRunning/** ModSdk process is already running. This error comes from the `EOSSDK. */
11001EOS_Mods_ModSdkCommandIsEmpty/** ModSdk command is empty. Either the ModSdk configuration file is missing or the manifest location is empty. */
11002EOS_Mods_ModSdkProcessCreationFailed/** Creation of the ModSdk process failed. This error comes from the SDK. */
11003EOS_Mods_CriticalError/** A critical error occurred in the external ModSdk process that we were unable to resolve. */
11004EOS_Mods_ToolInternalError/** An internal error occurred in the external ModSdk process that we were unable to resolve. */
11005EOS_Mods_IPCFailure/** An IPC failure occurred in the external ModSdk process. */
11006EOS_Mods_InvalidIPCResponse/** An invalid IPC response received in the external ModSdk process. */
11007EOS_Mods_URILaunchFailure/** A URI Launch failure occurred in the external ModSdk process. */
11008EOS_Mods_ModIsNotInstalled/** Attempting to perform an action with a mod that is not installed. This error comes from the external ModSdk process. */
11009EOS_Mods_UserDoesNotOwnTheGame/** Attempting to perform an action on a game that the user doesn't own. This error comes from the external ModSdk process. */
11010EOS_Mods_OfferRequestByIdInvalidResult/** Invalid result of the request to get the offer for the mod. This error comes from the external ModSdk process. */
11011EOS_Mods_CouldNotFindOffer/** Could not find the offer for the mod. This error comes from the external ModSdk process. */
11012EOS_Mods_OfferRequestByIdFailure/** Request to get the offer for the mod failed. This error comes from the external ModSdk process. */
11013EOS_Mods_PurchaseFailure/** Request to purchase the mod failed. This error comes from the external ModSdk process. */
11014EOS_Mods_InvalidGameInstallInfo/** Attempting to perform an action on a game that is not installed or is partially installed. This error comes from the external ModSdk process. */
11015EOS_Mods_CannotGetManifestLocation/** Failed to get manifest location. Either the ModSdk configuration file is missing or the manifest location is empty */
11016EOS_Mods_UnsupportedOS/** Attempting to perform an action with a mod that does not support the current operating system. */
12000EOS_AntiCheat_ClientProtectionNotAvailable/** The anti-cheat client protection is not available. Check that the game was started using the correct launcher. */
12001EOS_AntiCheat_InvalidMode/** The current anti-cheat mode is incorrect for using this API */
12002EOS_AntiCheat_ClientProductIdMismatch/** The ProductId provided to the anti-cheat client helper executable does not match what was used to initialize the `EOS SDK */
12003EOS_AntiCheat_ClientSandboxIdMismatch/** The SandboxId provided to the anti-cheat client helper executable does not match what was used to initialize the `EOS SDK */
12004EOS_AntiCheat_ProtectMessageSessionKeyRequired/** ProtectMessage/UnprotectMessage No session key is available, but it is required to complete this operation */
12005EOS_AntiCheat_ProtectMessageValidationFailed/** ProtectMessage/UnprotectMessage Message integrity is invalid */
12006EOS_AntiCheat_ProtectMessageInitializationFailed/** ProtectMessage/UnprotectMessage Initialization failed */
12007EOS_AntiCheat_PeerAlreadyRegistered/** RegisterPeer Peer is already registered */
12008EOS_AntiCheat_PeerNotFound/** UnregisterPeer Peer does not exist */
12009EOS_AntiCheat_PeerNotProtected/** ReceiveMessageFromPeer Invalid call: Peer is not protected */
13000EOS_RTC_TooManyParticipants/** `EOS RTC room cannot accept more participants */
13001EOS_RTC_RoomAlreadyExists/** `EOS RTC room already exists*/
13002EOS_RTC_UserKicked/** The user kicked out from the room */
13003EOS_RTC_UserBanned/** The user is banned */
13004EOS_RTC_RoomWasLeft/** `EOS RTC room was left successfully */
13005EOS_RTC_ReconnectionTimegateExpired/** Connection dropped due to long timeout */
14000EOS_ProgressionSnapshot_SnapshotIdUnavailable/** The number of available Snapshot IDs have all been exhausted. */
15000EOS_KWS_ParentEmailMissing/** The KWS user does not have a parental email associated with the account. The parent account was unlinked or deleted */
15001EOS_KWS_UserGraduated/** The KWS user is no longer a minor and trying to update the parent email */
17000EOS_Android_JavaVMNotStored/** `EOS Android VM not stored */
0x7FFFFFFF_LASTEOS_UnexpectedError/** An unexpected error that we cannot identify has occurred. */