Errors

In this guide, we will talk about what happens when something goes wrong while you work with the API. Let's look at some status codes and error types you might encounter.


Status codes

Here is a list of the different categories of status codes returned by the SDAPI API. Use these to understand if a request was successful.

  • Name
    200
    Description

    A 200 status code indicates a successful response.

  • Name
    201
    Description

    A 201 status code indicates an object was created successfully.

  • Name
    403
    Description

    A 403 status code indicates you are not authorized to access the resource. This may happen if you are not correctly authenticated, or have exceeded your resource limit(s).

  • Name
    403
    Description

    A 409 status code indicates an object of this exact shape already exists and cannot be created.

  • Name
    429
    Description

    A 429 status code indicates you have exceeded your rate limit.

  • Name
    500
    Description

    A 500 status code indicates a server error — we are working on a fix ASAP.


Error types

Whenever a request is unsuccessful, the SDAPI API will return an error status and a message. You can use this information to understand better what has gone wrong and how to fix it.

Error response

{
  "message": "Something terrible has happened",
  "status": 500
}

Was this page helpful?