Skip to main content

Export NuORDER Products

GET 

/api/nuorder/instances/:integrationInstance/products/export

Downloads the products list (one row per size) as CSV or XLSX, with the same filters and sort as List NuORDER Products. Archived sizes are left out unless an archived filter is sent.

Required scope: products:read

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Query parameters:

  • format (string, optional) — csv (default) or xlsx.
  • included (string, optional) — JSON list of column keys to include, in order: style, sku, mapped_product, color, season, size, upc, wholesale_price, retail_price, inventory_push, nuorder_modified_at, status. A key selects every field that starts with it. Default: every column.
  • filter[ids] (string, optional) — comma-separated size IDs to export only those.
  • filter[...], sort — the List NuORDER Products filters and sort.

The file always starts with Sr No. and ID; date-time columns are in the account's timezone, and their headers (Last Inventory Push, Last Modified, Archived At) always name it, e.g. Last Modified (America/New_York), even when every row is blank.

Inventory Push reads like the grid's column: Push error: <message>, Not mapped (no SKU.io product or offering), Not pushed, Pushed or Never pushed.

Large exports: up to 1,000 rows the response is the file itself (200). Above 1,000 rows the export is built in the background and the response is 202 JSON with data.queued, data.tracked_job_log_id and data.record_count. When the job finishes, its results.download_url (GET /api/export/download?file=...) serves the file to the user who started it.

Authentication: Bearer token (Personal Access Token).

Request​

Responses​

Accepted

Response Headers
    Content-Type