Skip to content

Most visited

Recently visited

added in API level 1


public class JSONException
extends Exception

   ↳ java.lang.Throwable
     ↳ java.lang.Exception
       ↳ org.json.JSONException

Thrown to indicate a problem with the JSON API. Such problems include:

  • Attempts to parse or construct malformed documents
  • Use of null as a name
  • Use of numeric types not available to JSON, such as NaNs or infinities.
  • Lookups using an out of range index or nonexistent name
  • Type mismatches on lookups

Although this is a checked exception, it is rarely recoverable. Most callers should simply wrap this exception in an unchecked exception and rethrow:

  public JSONArray toJSONObject() {
     try {
         JSONObject result = new JSONObject();
     } catch (JSONException e) {
         throw new RuntimeException(e);


Public constructors

JSONException(String s)
JSONException(String message, Throwable cause)
JSONException(Throwable cause)

Inherited methods

Public constructors


added in API level 1
JSONException (String s)

s String


added in API level 27
JSONException (String message, 
                Throwable cause)

message String

cause Throwable


added in API level 27
JSONException (Throwable cause)

cause Throwable

This site uses cookies to store your preferences for site-specific language and display options.

Get the latest Android developer news and tips that will help you find success on Google Play.

* Required Fields


Follow Google Developers on WeChat

Browse this site in ?

You requested a page in , but your language preference for this site is .

Would you like to change your language preference and browse this site in ? If you want to change your language preference later, use the language menu at the bottom of each page.

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a short survey?
Help us improve the Android developer experience. (April 2018 — Developer Survey)