title: SDK Error Code

Mappls SDK – Error Code Reference¶

This document outlines possible error codes and exceptions encountered while using the Mappls Android SDKs. Use this guide for debugging integration issues across different SDK modules.

Core SDK Errors¶

Condition	Exception/Error Message
Mappls Plugin is not applied in `build.gradle`	`Please apply plugin "com.mappls.services.android" in your app/build.gradle`
`.olf` file is invalid or corrupted	`Please add a valid .olf configuration file.`
Package name or app fingerprint mismatch in `.olf` file	`You are using Invalid Configuration. Please check your Package Name / App Fingerprint & download it from the developer console again.`
`.conf` config file is invalid	`Please add a valid .conf configuration file.`
Static key is not found (improper app setup or missing plugin)	`Error Code: 1` `Error Message: Static Key Not Found` No HTTP status code associated
Invalid payload while creating the payload JSON	`Error Code: 2` `Error Message: Invalid Payload` No HTTP status code associated
Missing config data, `appId`, or `payloadPubKey`	`Error Code: 3` `Error Message: Invalid Config` No HTTP status code associated
Payload encryption failure	`Error Code: 3` `Error Message: Invalid Payload` No HTTP status code associated
Auth1 Token (Bearer accessToken) missing or expired during API call	`Error Code: 5` `Error Message: Authentication Failed` No HTTP status code associated
Auth1 Token usage attempted but config lacks access token	`Error Code: 6` `Error Message: This authentication is not supported` No HTTP status code associated

Rest API SDK Errors¶

Condition	Exception/Error Message
Method not provisioned	`Error Code: 4` `Error Message: Method not Provisioned` No HTTP status code associated
API call manually cancelled by user	`Error Code: 9` `Error Message: <Exception message>` No HTTP status code associated
No internet connection / Unknown host	`Error Code: 10` `Error Message: <UnknownHost Exception message>` No HTTP status code associated
API failure due to an unexpected issue / Invalid response	`Error Code: 11` `Error Message: <Exception message>` No HTTP status code associated

Map SDK Errors¶

Condition	Exception/Error Message
Config not read properly by Map SDK (improper setup)	`Error Code: 7` `Error Message: Map Config not available`
`vectorMap` object or style base URL missing in config	`Error Code: 7` `Error Message: Map Info is not available`
Public key or its expiry missing from `vectorMap` object in config	`Error Code: 8` `Error Message: Public Key not found`

Android – Mappls Plugin Errors¶

Condition	Exception/Error Message
`.a.olf` file is missing in the project	`No .a.olf file found. The Mappls Services Plugin cannot function without it.`
`.conf` config file is missing	`.conf file not found at: <path>`

Note¶

These errors are internal SDK exceptions and may not return standard HTTP status codes.
Make sure all configuration files are correctly downloaded and integrated from the Mappls Developer Console.
Always apply the com.mappls.services.android plugin and include required dependencies in your build.gradle.

For any queries and support, please contact:

Email us at apisupport@mappls.com

Support
Need support? contact us!