v29

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-06-042661,1122.5 MB
catalog_items

Get item batch status

Get a single catalogs items batch owned by the "operating user_account". See detailed documentation here.

  • By default, the "operation user_account" is the token user_account.

Optional: Business Access: Specify an ad_account_id (obtained via List ad accounts) to use the owner of that ad_account as the "operation user_account". In order to do this, the token user_account must have one of the following Business Access roles on the ad_account: Owner, Admin, Catalogs Manager.

get/catalogs/items/batch/{batch_id}

Path parameters

batch_idstring required

Id of a catalogs items batch to fetch

Query parameters

ad_account_idstring

Unique identifier of an ad account.

Response

The request has succeeded.

OR
OR

Example response

{
  "completed_time": "2024-01-01T20:20:00Z",
  "created_time": "2024-01-01T20:10:40Z",
  "items": [
    {
      "errors": [
        {
          "attribute": "title",
          "code": 106,
          "message": "Title is missing from product metadata."
        }
      ],
      "item_id": "DS0294-M",
      "status": "SUCCESS",
      "warnings": [
        {
          "attribute": "title",
          "code": 106,
          "message": "Title is missing from product metadata."
        }
      ]
    }
  ],
  "status": "PROCESSING"
}