errors

When something goes wrong, the response body looks like this:

{
  "success": false,
  "error": {
    "code": "...",
    "message": "...",
    "details": { }
  }
}

The details object is optional and varies per error for example, INSUFFICIENT_INVENTORY includes the items with stock shortfalls.

All error codes

Code	HTTP	Endpoints	Plain-English meaning
`VALIDATION_FAILED`	400	both	The request body is missing a field or has the wrong type. The response says which field.
`INVALID_PART_TOKEN`	400	orders	A `part_id` you sent isn’t recognized. Look up the part again.
`INVALID_API_KEY`	401	both	Your API key is missing, malformed, or wrong.
`KEY_REVOKED`	401	both	The API key you used was revoked. Email info@skynetparts.com for a replacement.
`INSUFFICIENT_INVENTORY`	409	orders	One or more items don’t have enough stock. Response lists which.
`IDEMPOTENCY_CONFLICT`	409	orders	You sent an `Idempotency-Key` we’ve already seen, but with a different order body.
`IDEMPOTENCY_IN_PROGRESS`	409	orders	A request with this `Idempotency-Key` is still being processed. Retry shortly.
`RATE_LIMITED`	429	catalog, products	Too many requests in a short window. Retry in a few seconds.
`UPSTREAM_ERROR`	502	catalog, products	Catalog lookup failed on our end. Safe to retry.
`ORDER_FAILED`	502	orders	Order placement failed on our end. Your order was not placed. Safe to retry.
`UPSTREAM_TIMEOUT`	504	catalog, products	The catalog lookup timed out. Safe to retry.

Note: parts that aren’t in our catalog are returned in the not_found array of a successful Look Up Parts response they are not an error. If you hit an error not in this list, email info@skynetparts.com with the response body and timestamp.

Get Started

API

Reference

All error codes

​All error codes

All error codes