How an import is going
Needs the scope products:read
Its status, how many rows it has processed and a count for each result.
importId*stringThe import id.
uuidOK
application/json- response
id*stringuuidstatus*string"queued""running""completed""failed"dryRun*booleanorderId*|The order the imported products landed in (null for a dry run).
rows*|Rows in the file, once read.
processed*integercounts*How many rows ended in each result so far.
error*|Why the import failed, when it did.
createdAt*stringdate-timefinishedAt*|nullcurl -sS https://platform.charpstar.co/api/v1/imports/$IMPORT_ID \ -H "Authorization: Bearer $CHARPSTAR_API_KEY"{ "id": "7a6b5c4d-0000-4000-8000-000000000022", "status": "running", "dryRun": false, "orderId": "4d3c2b1a-0000-4000-8000-000000000011", "rows": 1200, "processed": 350, "counts": { "created": 300, "updated": 40, "unchanged": 8, "change_request": 0, "exists_delivered": 0, "refused": 2 }, "error": null, "createdAt": "2026-10-20T09:31:00.000Z", "finishedAt": null}Load many products from a file POST
Load many products from one file, for a first catalogue load or a full refresh. - The file is NDJSON (one product per line in the POST /api/v1/products format) or CSV with the same field names in the header row, up to 100,000 products, fetched from an https link. - The import runs in the background and applies the same rules as POST /api/v1/products. import.completed is sent when it has finished. - With dryRun the whole file is checked and nothing is written.
The result of every row GET
One line per product, NDJSON, with the same fields as a POST /api/v1/products result plus the row number. Available once the import has finished.