This page describes the common HTTP response codes that applies to all Picsart APIs.

Picsart uses conventional HTTP response codes to indicate the success or failure of an API request.

Error CodeMessageDescription
200SuccessCongratulations, your call was successful.
400Bad requestThe server could not understand the request due to invalid syntax or input parameters that did not meet the requirements.
401UnauthorizedAlthough the HTTP standard specifies "unauthorized", semantically this response means "unauthenticated". That is, the client must authenticate itself to get the requested response. Check if the APIKEY is provided in either the request header or in the query string.
403ForbiddenThe client does not have access rights to the content; that is, it is unauthorized, so the server is refusing to give the requested resource. Unlike 401, the client's identity is known to the server.
404Not FoundNot found. Verify that the request URL is spelled correctly and that the API you are trying to access exists. For example, ensure that you are not trying to access the wrong revision of an API.
405Method Not AllowedMethod not allowed. You specified a method that is not supported. For example, you used the GET verb for an API call that requires the POST verb.
413Request Entity Too LargeRequest Entity Too Large.
415Unsupported Media TypeThe media format of the requested data is not supported by the server, so the server is rejecting the request.

Typically, this error occurs on POST or PUT requests when the Content-type HTTP header is set to the wrong value. For example, an HTTP 415 error is returned if you POST the following to an API that only supports JSON:

$ curl
-H "Content-type:text/xml"
-d ''

For GET requests, use the Accept header instead of the Content-type header.
429Too Many RequestThe rate limit was exceeded on Quota.
431Request Header Fields Too LargeRequest Header Fields Too Large.
500Internal Server ErrorThe server encountered an unexpected condition that prevented it from fulfilling the request. If the error persists, please, check the service status at
503Service UnavailableThe service is temporarily unavailable. Please, check the current status at

For high error rates, you can check the service status at There you can subscribe for updates, including upcoming maintenance. In case you don’t see the problem escalated on the Status page, please contact us with a Request type of ‘Troubleshooting’ or send a direct email to [email protected]. We will make sure to follow up as soon as possible.