List Pre-Start-Date Orders
GET/api/big-commerce/:integrationInstance/pre-start-date-orders
Query the BigCommerce store live for orders created before your SKU.io inventory start date, so historical orders can be selectively imported without affecting inventory.
Any valid API token can call this endpoint — no specific scope required. Manage tokens.
Each returned order carries an eligible flag with an eligibility_reason (cancelled and refunded orders are not eligible) and an already_imported flag for orders that already exist locally.
Both dates must be before the inventory start date. Returns up to 2,500 matching orders per query.
Route name: big-commerce.pre-start-date-orders.query
Request
Responses
- 200
- 401
- 403
- 404
- 422
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.
Unprocessable Entity
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.