Guides

Errors

Understand SellApp API error responses and failure modes.

What happens when something goes wrong while you are interacting with the API? Mistakes happen, so this guide covers the status codes and error types you may encounter.

Note

Before reaching out to support with an issue, carefully check your code for incorrectly typed variables and missing or malformed headers.

You can tell if a request was successful by checking the HTTP status code on the response. If a response is unsuccessful, use the error type and message to understand what went wrong and to debug the request.


Status codes

Here are the status code categories returned by the SellApp API:

Name
2xx
Description

A 2xx status code indicates a successful response.

Name
4xx
Description

A 4xx status code indicates a client error.

Name
5xx
Description

A 5xx status code indicates a server error.


Error types

Whenever a request is unsuccessful, the SellApp API returns an error response with an error type and message. Use this information to understand what went wrong and how to fix it.

The list of error codes may grow over time. The following code is currently documented in the legacy API reference:

Name
1020
Description

This means either the API key passed along is incorrectly formatted, or you are missing a required header.

On this page