Errors and pagination

Errors

A failed request returns a JSON error body with an HTTP status.

{
  "error": "Validation Error",
  "code": 400,
  "errorCode": "validation_error",
  "suggestion": "Please check your request data and try again",
  "requestId": "58506219-5893-43d4-9948-324c3c0ce362",
  "details": { "issues": [{ "path": ["limit"], "message": "Too big: expected number to be <=100" }] }
}

Field	Meaning
`error`	What went wrong, readable by a person
`code`	The HTTP status
`errorCode`	A stable code to branch on
`suggestion`	What to try next
`requestId`	Send this to support when you report a problem
`details`	The invalid fields, in `details.issues`

Status	Meaning
400	The request failed validation
401	The API key is missing or invalid
403	The API key’s role cannot call this endpoint
404	The resource or route does not exist
429	The key hit its rate limit
5xx	Pure failed; retry with backoff

Pagination

List endpoints page with limit and offset.

curl "https://api.collectpure.com/orders/get-sale-orders/v1?limit=50&offset=100" \
  -H "x-api-key: YOUR_API_KEY"

Each endpoint’s default and maximum limit are in the API Reference.

Get Started

Basics

Errors