Error Responses

Understand how to effectively handle and troubleshoot error responses when interacting with the Picsart Creative APIs.

After submitting an API call to Picsart, you receive a response back to inform you that your request was received and processed. Depending on the HTTP status code of the response, you should build some logic to handle any errors that a request or the system may return. Errors are consistent and include information to help troubleshoot.

The Picsart API uses standard HTTP response codes to let you know when something's wrong. It also returns some useful information to help you troubleshoot.


For a comprehensive overview of all the errors you might encounter when working with the Picsart API, check out our error reference. Each error includes common causes and information on how to fix.

HTTP status codes

Implementation errors generally return a 4xx response code.

Though rare, you may get a 5xx response code. This means that there's a problem with the Picsart API rather than your code. In these cases you receive an error message with an error code containing a description of the problem. In general, you should handle it as an exception. Try your request later, or check our status page.

  "code": 0,
  "message": "string",
  "detail": "string"


Success responses return a 2xx status code.

See also

IETF HTTP status code registry
RFC 2616, section 6.1.1
HTTP status codes on Wikipedia