Skip to main content

Overview

The Partoo API uses standard HTTP response codes to indicate success or failure. This guide covers the most common error codes and how to respond to them effectively.
HTTP status codes are grouped into three categories:
  • 2xx: Success
  • 4xx: Client Errors
  • 5xx: Server Errors
The request is malformed or missing required fields.
{
  "error": {
    "json": {}
  }
}
No valid API key was provided.
{
  "error": {
    "authentication": "User not authenticated"
  }
}
The API key doesn’t have permission to perform this request.
{
  "error": {
    "authorization": "Operation not allowed"
  }
}
The resource you’re looking for doesn’t exist.
{
  "error": {
    "json": "Resource not found"
  }
}
Ensure that the Content-Type header is set to application/json on POST, PUT, and PATCH requests.
{
  "errors": {
    "json": "Unsupported media type. Please use application/json"
  }
}
Your application has hit the rate limit.See Rate Limits for more information.