Refresh Orders from BigCommerce

POST 
/api/big-commerce/:integrationInstance/orders/refresh-tracked

Start a background refresh that downloads orders from BigCommerce into SKU.io.

Authorization

Any valid API token can call this endpoint — no specific scope required. Manage tokens.

The mode field controls which orders are fetched:

• latest (default) - orders modified since the most recent local order
• from_start_date - orders modified since the integration's configured start date
• date_range - orders modified within the date_from / date_to range
• all - every order in the store

The job runs asynchronously. The response includes a tracked_job_log_id you can use to poll job progress.

Route name: big-commerce.orders.refresh-tracked

Request

Responses

200

OK

Response Headers

Content-Type

401

Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.

403

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.

404

Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.

422

Unprocessable Entity

Response Headers

Content-Type

429

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.