Error Handling

Understand Marketplace API errors and status codes.

All errors reported by the REST API have an HTTP status code and follow the standard format.

When an error occurs, the response body usually contains a JSON object with the following fields:

{
  "type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
  "title": "Bad Request",
  "status": 400,
  "detail": "One or more validation errors occurred.",
  "traceId": "00-9e02a91b64ac56904703a3a69ea9101d-56be90a29d0b0b25-00",
  "errors": {
    "mistake": [
      "Unknown expression group."
    ]
  }
}

• type - [string] A URI reference that identifies the error type, providing a consistent way to categorize errors across different API implementations.

• title - [string] A human-readable title or summary of the error.

• status - [number] The HTTP status code associated with the error.

• detail - (Optional) [string] A detailed human-readable description of the error, providing additional information to help clients understand the issue.

• instance - (Optional) [string] A URI reference that identifies the specific occurrence of the error, useful for debugging or tracing purposes.

• traceId - (Optional) [string] A unique identifier to trace requests in logs.

• errors - (Optional) [key-value] A collection of errors detected by validation logic.

Common errors

The following table lists some of the common errors:

HTTP status	Description
401 Unauthorized	This means the request lacks valid authentication credentials for the target resource. Check if the Authorization header is present and contains the valid token value.
403 Forbidden	The server understands the request but refuses to authorize it.
404 Not Found	The requested resource could not be found on the server.
409 Conflict	The request could not be completed due to a conflict with the current state of the resource.
415 Unsupported Media Type	The server refuses the request because the payload format is not supported.
500 Internal Server Error	The server encountered an unexpected condition that prevented it from fulfilling the request.
501 Not Implemented	The server does not support the functionality required to fulfill the request.
504 Gateway Timeout	The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server.