HomeGuidesAPI ReferenceChangelogSupport Request
Guides

Check Batchrequest Result (getBatchRequestResult)

Check Batchrequest Result (getBatchRequestResult)

While createProducts, updatePriceAndInventory methods are processed by the queue in TrendyolSystem, a batchRequestId information is returned in each successful request result. By checking the "status" field in the return of the service, you can check whether the batch has been completed. If more than one item in the batch results in an error, the failureReasons field can be checked to see error reason.

  • You can see the batch request results' createProducts,updateProducts and updatePriceAndInventory services up to 4 hours later.
  • After the Stock Price update processes, you need to check the item-based status fields for the batchId you are querying. Batch status field will not return to you.

GET getBatchRequestResult

Sample Service Response for ProductCreate

{
    "batchRequestId": "string",
    "status": "IN_PROGRESS | COMPLETED",
    "creationDate": 0,
    "lastModification": 0,
    "sourceType": "API",
    "itemCount": 0,
    "failedItemCount": 0,
    "batchRequestType": "ProductV2OnBoarding",
    "items": [
        {
            "requestItem": {
                "barcode": "string",
                "product": {
                    "barcode": "string",
                    "title": "string",
                    "productMainId": "string",
                    "brandId": 0,
                    "categoryId": 0,
                    "quantity": 0,
                    "stockCode": "string",
                    "dimensionalWeight": 0.0,
                    "specialConsumptionTax": 0.0,
                    "description": "string",
                    "currencyType": "string",
                    "listPrice": 0.0,
                    "salePrice": 0.0,
                    "vatRate": 0,
                    "images": [
                        {
                            "url": "string"
                        }
                    ],
                    "attributes": [
                        {
                            "attributeId": 0,
                            "attributeValueId": 0,
                            "customAttributeValue": "string"
                        }
                    ],
                    "cargoCompanyId": 0,
                    "shipmentAddressId": 0,
                    "returningAddressId": 0,
                    "lotNumber": "string"
                }
            },
            "status": "SUCCESS | FAILED",
            "failureReasons": [
                "string"
            ]
        }
    ]
}

Sample Service Response for ProductUpdate for Unapproved Products

{
    "batchRequestId": "string",
    "status": "IN_PROGRESS | COMPLETED",
    "creationDate": 0,
    "lastModification": 0,
    "sourceType": "API",
    "itemCount": 0,
    "failedItemCount": 0,
    "batchRequestType": "ProductV2Update",
    "items": [
        {
            "requestItem": {
                "barcode": "string",
                "product": {
                    "barcode": "string",
                    "title": "string",
                    "productMainId": "string",
                    "brandId": 0,
                    "categoryId": 0,
                    "stockCode": "string",
                    "dimensionalWeight": 0.0,
                    "specialConsumptionTax": 0.0,
                    "description": "string",
                    "vatRate": 0,
                    "images": [
                        {
                            "url": "string"
                        }
                    ],
                    "attributes": [
                        {
                            "attributeId": 0,
                            "attributeValueId": 0,
                            "customAttributeValue": "string"
                        }
                    ],
                    "cargoCompanyId": 0,
                    "shipmentAddressId": 0,
                    "returningAddressId": 0,
                    "deliveryDuration": 0,
                    "deliveryOption": {
                        "deliveryDuration": 0,
                        "fastDeliveryType": "string"
                    },
                    "contentId": 0,
                    "locationBasedDelivery": "ENABLED|DISABLED|null",
                    "lotNumber": "string"
                }
            },
            "status": "SUCCESS | FAILED",
            "failureReasons": [
                "string"
            ]
        }
    ]
}

Sample Service Response for ProductUpdate for Approved Products - Content Update

{
    "batchRequestId": "string",
    "status": "IN_PROGRESS | COMPLETED",
    "creationDate": 0,
    "lastModification": 0,
    "sourceType": "API",
    "itemCount": 0,
    "failedItemCount": 0,
    "batchRequestType": "ApprovedProductContentUpdate",
    "items": [
        {
            "requestItem": {
                "supplierId": 0,
                "updateRequest": {
                    "contentId": 0,
                    "categoryId": 0,
                    "brandId": 0,
                    "title": "string",
                    "description": "string",
                    "images": [
                        {
                            "url": "string"
                        }
                    ],
                    "attributes": [
                        {
                            "attributeId": 0,
                            "attributeValueId": 0,
                            "customAttributeValue": "string"
                        }
                    ]
                }
            },
            "status": "SUCCESS | FAILED",
            "failureReasons": [
                "string"
            ]
        }
    ]
}

Sample Service Response for ProductUpdate for Approved Products - Variant Update

{
    "batchRequestId": "string",
    "status": "IN_PROGRESS | COMPLETED",
    "creationDate": 0,
    "lastModification": 0,
    "sourceType": "API",
    "itemCount": 0,
    "failedItemCount": 0,
    "batchRequestType": "ApprovedProductVariantUpdate",
    "items": [
        {
            "requestItem": {
                "supplierId": 0,
                "updateRequest": {
                    "barcode": "string",
                    "stockCode": "string",
                    "vatRate": 0,
                    "shipmentAddressId": 0,
                    "returningAddressId": 0,
                    "dimensionalWeight": 0.0,
                    "lotNumber": "string",
                    "locationBasedDelivery": "string",
                    "specialConsumptionTax": 0.0
                }
            },
            "status": "SUCCESS | FAILED",
            "failureReasons": [
                "string"
            ]
        }
    ]
}

Sample Service Response for ProductUpdate for Approved Products - Delivery Information Update

{
    "batchRequestId": "string",
    "status": "IN_PROGRESS | COMPLETED",
    "creationDate": 0,
    "lastModification": 0,
    "sourceType": "API",
    "itemCount": 0,
    "failedItemCount": 0,
    "batchRequestType": "ProductDeliveryOptionUpdate",
    "items": [
        {
            "requestItem": {
                "supplierId": 0,
                "barcode": "string",
                "storeFrontCode": "TR",
                "storeFrontId": 1,
                "request": {
                    "barcode": "string",
                    "deliveryOption": {
                        "deliveryDuration": 0,
                        "fastDeliveryType": "string"
                    }
                }
            },
            "status": "IN_PROGRESS | SUCCESS | FAILED",
            "failureReasons": [
                "string"
            ]
        }
    ]
}

Sample Service Response for Stock&PriceUpdate

{
    "batchRequestId": "c57e3453-2c00-11f0-aa3a-be9298facace-1746718627",
    "items": [
        {
            "requestItem": {
                "updateRequestDate": "2025-05-08T11:37:07.950+00:00",
                "quantity": 100,
                "salePrice": 100,
                "barcode": "11111111111",
                "listPrice": 100
            },
            "status": "SUCCESS",
            "failureReasons": []
        }
    ],
    "creationDate": 1746704227943,
    "lastModification": 1746704227943,
    "sourceType": "API",
    "itemCount": 1,
    "failedItemCount": 0,
    "batchRequestType": "ProductInventoryUpdate"
}

Sample Service Response for Product Archive

{
  "batchRequestId": "8e12d3fe-2d72-4ed0-b1e5-a4e4d7290bd5-1754145895",
  "items": [
    {
      "requestItem": {
        "archived": true,
        "supplierId": 2748,
        "barcode": "TestProduct"
      },
      "status": "SUCCESS",
      "failureReasons": [],
      "batchRequestLogId": "1ebea453-6ed2-4638-8977-1713bb34845d"
    }
  ],
  "status": "COMPLETED",
  "creationDate": 1753886695467,
  "lastModification": 1753886695467,
  "sourceType": "WEB",
  "itemCount": 1,
  "failedItemCount": 0,
  "batchRequestType": "ProductArchiveUpdate",
  "notes": null
}

Sample Service Response for Product Delete

{
  "batchRequestId": "8e0fbad0-ea9d-4fca-ac8c-1837062ea6bf-1757328512",
  "items": [
    {
      "requestItem": {
        "barcode": "TestProduct"
      },
      "status": "SUCCESS",
      "failureReasons": []
    }
  ],
  "status": "COMPLETED",
  "creationDate": 1757314112508,
  "lastModification": 1757314114851,
  "sourceType": "API",
  "itemCount": 1,
  "failedItemCount": 0,
  "batchRequestType": "ProductDeletion"
}

Sample Service Response for Product Unlock

{
    "batchRequestId": "string",
    "status": "IN_PROGRESS | COMPLETED",
    "creationDate": 0,
    "lastModification": 0,
    "sourceType": "API",
    "itemCount": 0,
    "failedItemCount": 0,
    "batchRequestType": "ProductUnlockUpdate",
    "items": [
        {
            "requestItem": {
                "barcode": "string"
            },
            "status": "IN_PROGRESS | SUCCESS | FAILED",
            "failureReasons": [
                "string"
            ]
        }
    ]
}