Errors

Damn it. What happened now?

HTTP Errors
Here is a list of the most common HTTP errors you'll encounter. All errors return in a JSON format. In addition to returning the HTTP status codes, we also return an error message. There are different error types that are specific to certain use cases in the API.
HTTP Errors
JSON Error Messages
HTTP Errors
HTTP Status Code
Short Description
Description
200
OK
The action requested by the client was received, understood and accepted.
400
Bad Request
Cannot process the request. Most often because of a malformed syntax.
401
Unauthorized
The client is not authorized to make this API request.
403
Forbidden
You shall not pass. The user might not have the right permissions or may need a particular account.
404
Not Found
The resource requested is, wait for it, not found.
500
Internal Server Error
There was an unexpected error.  This might be our bad, sorry.
503
Timed Out
The request timed out.  There is a 30 second limit.
JSON Error Messages
Error Type
HTTP Status Code
Description
ValidationError
400
Most often caused by a malformed syntax.
FieldDoesNotExist
400
A PUT request that tries to update a field that does not exist.
StateMachineError
400
An object is not allowed to change state in the order requested.
AuthorizationError
401
The client is not authorized to perform this request.
DoesNotExist
404
Used in GET request when querying for a specific ID and it doesn't exist.
The errors come in this format:
{
    "code": <status code>,
    "message": <A short message regarding the error>,
    "description": <A generic description of the error>,
    "error": {
        "type": <The error type above>,
        "exception_description": <A more specific error description>
        }
}
The description in the returned errors may vary slightly between different API calls.
Core SDK & Node SDK
Python SDK
Core SDK & Node SDK
builton.products.get('58ab022id0n7ex1st3045dbf').then((product) => {
  console.log(product);
}).catch((err) => {
  console.error(err.response.body);
  /*
    {
      code: 404,
      message: 'Getting product failed.',
      description: 'getting product:58ab022id0n7ex1st3045dbf failed',
      error: 
       { type: 'DoesNotExist',
         exception_description: 'the Product with id: \'58ab022id0n7ex1st3045dbf\' does not exist',
         params: '58ab022id0n7ex1st3045dbf'
       }
    }
  */
});
Python SDK
try:
    builton.product().get('58ab022id0n7ex1st3045dbf')
except Exception as error:
    print(error)
​
    """
    {
        'code':404,
        'message':'Getting product failed.',
        'description':'getting product:58ab022id0n7ex1st3045dbf failed',
        'error':{
            'type':'DoesNotExist',
            'exception_description':"the Product with id: '58ab022id0n7ex1st3045dbf' does not exist",
            'params':'58ab022id0n7ex1st3045dbf'
        }
    }
    """

Nuts & Bolts - Previous

Pagination

Next - Nuts & Bolts

Common GET Parameters

Last updated 10 months ago

Error Type	HTTP Status Code	Description
`ValidationError`	`400`	Most often caused by a malformed syntax.
`FieldDoesNotExist`	`400`	A `PUT` request that tries to update a field that does not exist.
`StateMachineError`	`400`	An object is not allowed to change state in the order requested.
`AuthorizationError`	`401`	The client is not authorized to perform this request.
`DoesNotExist`	`404`	Used in `GET` request when querying for a specific ID and it doesn't exist.

HTTP Status Code	Short Description	Description
`200`	OK	The action requested by the client was received, understood and accepted.
`400`	Bad Request	Cannot process the request. Most often because of a malformed syntax.
`401`	Unauthorized	The client is not authorized to make this API request.
`403`	Forbidden	You shall not pass. The user might not have the right permissions or may need a particular account.
`404`	Not Found	The resource requested is, wait for it, not found.
`500`	Internal Server Error	There was an unexpected error. This might be our bad, sorry.
`503`	Timed Out	The request timed out. There is a 30 second limit.