Error message format

When an error occurs in the processing of an API request, an error message is returned. The following table lists the attributes in the JSON payload of an error message.

Attribute

Data type

Description

errorCode

String

A string that uniquely identifies the type of error that occurred. Useful for programmatic handling of specific error conditions.

message

String

A short description of the error that occurred.

details

String

A detailed description of the error.

recommendedActions

Array<String>

A list of strings indicating suggested user actions or resolutions for the specific error condition.

nestedErrors

Array<ErrorMessage>

For multi-part errors (for example, form-validation errors), this field may contain specific of the individual components of the error (for example, individual fields in error).

errorSource

String

For multi-part errors (for example, form validation errors), this field contains the identifier of the sub-component in error (for example, the individual field name).

data

Object

Internal/additional data associated with the error. External clients will usually ignore this field.