Skip to main content

Upload batch of products

POST 
/platform/v1/:project-id/products/batch/upload

Use this endpoint to upload a batch of products following the example JSON schema. Each batch can contain up to 10,000 products. Repeat this step until all products have been uploaded.

If the uploaded JSON breaks the JSON schema, you will get detailed information about the error in the API response.

Please check the status attribute in the JSON response after each batch. The response should contain status: success. Only proceed with the next batch if the request was successful.

Important: all attribute objects in the attributes array need to have the value given as a string. Even numeric values need to be converted to strings. Additonally, numeric values must have a unit, such as "EUR" for the "Price" attribute or "in" for "Length".

Request​

Responses​

OK

{
    "message": "Upload initiated",
    "status": "success",
    "task": {
        "projectId": 39074,
        "projectName": null,
        "origin": "LIVE-API",
        "taskStatus": "PENDING",
        "name": "",
        "taskIncrementType": "ITEM_BASED",
        "failure": false,
        "requestTime": 1744211013700,
        "startTime": 1744211013728,
        "finishTime": null,
        "progress": 0,
        "logCounter": 1,
        "id": "67f68c453254c723d5ff0aee"
    },
    "nrOfSent": 500,
    "nrOfParsed": 500
}