List Pre-Start-Date Orders
GET/api/shopify/:integrationInstance/pre-start-date-orders
Queries the Shopify Admin API live for orders created before the account's inventory start date and returns them with an eligibility assessment for historical import (eligible, already imported, or the reason they cannot be imported). Orders imported this way are flagged as pre-start-date imports and do not affect inventory.
Any valid API token can call this endpoint — no specific scope required. Manage tokens.
Authentication: Requires Bearer token.
Note: this performs live Shopify API requests and can be slow for wide date ranges.
Query parameters:
- created_at_min (date, required): start of the window; must be before the inventory start date.
- created_at_max (date, optional): end of the window; defaults to the day before the inventory start date; must be before the inventory start date and not before created_at_min.
- fulfillment_status (string, optional): unfulfilled, partial, fulfilled, or any.
Returns 422 if the inventory start date has not been set or the dates are out of range.
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.