--- title: "Changes to Get item batch status" method: GET path: "/catalogs/items/batch/{batch_id}" --- # Changes to Get item batch status `GET /catalogs/items/batch/{batch_id}` > Every recorded change to this operation, newest first. ## Timeline Changed in 10 of 29 revisions. - **2026-06-04** (v5) `b698c180678a`: 4 breaking, 1 warning, 18 info - **2025-12-11** (v5) `79f62f71f05b`: 1 breaking, 1 info - **2025-04-04** (v5) `10f9eba4ad97`: 1 breaking, 2 info - **2024-08-14** (v5) `89c27ed39cfd`: 1 info - **2024-04-23** (v5) `f9321315766f`: 1 breaking, 5 warning, 1 info - **2023-08-17** (v5) `0ff12596bafd`: 1 breaking, 5 warning, 2 info - **2022-11-14** (v5) `e041d7b0cef0`: 2 info - **2022-04-12** (v5) `723c51158044`: 3 breaking, 6 info - **2022-04-08** (v5) `33ec8e7421c7`: 2 breaking, 7 warning - **2022-04-08** (v5) `c561dee8c137`: 1 info ## Changes - **2026-06-04** (v5) `b698c180678a`: 4 breaking, 1 warning, 18 info - the `oneOf[#/components/schemas/CatalogsCreativeAssetsItemsBatch]/batch_id` response's property type changed from `string` to no type for status `200` - the `oneOf[#/components/schemas/CatalogsHotelItemsBatch]/batch_id` response's property type changed from `string` to no type for status `200` - the `oneOf[#/components/schemas/CatalogsRetailItemsBatch]/batch_id` response's property type changed from `string` to no type for status `200` - removed the required property `catalog_type` from the response with the `200` status - changed the pattern of the `path` request parameter `batch_id` from `^[a-zA-Z0-9]+$` to `^\d+$` - added the non-success response with the status `400` - added the non-success response with the status `429` - removed the non-success response with the status `405` - the response optional property `oneOf[#/components/schemas/CatalogsCreativeAssetsItemsBatch]/completed_time` became not read-only for the status `200` - the response optional property `oneOf[#/components/schemas/CatalogsCreativeAssetsItemsBatch]/created_time` became not read-only for the status `200` - the response optional property `oneOf[#/components/schemas/CatalogsHotelItemsBatch]/completed_time` became not read-only for the status `200` - the response optional property `oneOf[#/components/schemas/CatalogsHotelItemsBatch]/created_time` became not read-only for the status `200` - the response optional property `oneOf[#/components/schemas/CatalogsRetailItemsBatch]/completed_time` became not read-only for the status `200` - added `#/components/schemas/Pinterest.Lib.IntegerFormatType` to the `oneOf[#/components/schemas/CatalogsCreativeAssetsItemsBatch]/batch_id` response property `allOf` list for the response status `200` - added `#/components/schemas/Pinterest.Lib.IntegerFormatType` to the `oneOf[#/components/schemas/CatalogsHotelItemsBatch]/batch_id` response property `allOf` list for the response status `200` - added `#/components/schemas/Pinterest.Lib.IntegerFormatType` to the `oneOf[#/components/schemas/CatalogsRetailItemsBatch]/batch_id` response property `allOf` list for the response status `200` - removed the `CREATIVE_ASSETS` enum value from the `oneOf[#/components/schemas/CatalogsHotelItemsBatch]/catalog_type` response property for the response status `200` - removed the `CREATIVE_ASSETS` enum value from the `oneOf[#/components/schemas/CatalogsRetailItemsBatch]/catalog_type` response property for the response status `200` - removed the `HOTEL` enum value from the `oneOf[#/components/schemas/CatalogsCreativeAssetsItemsBatch]/catalog_type` response property for the response status `200` - removed the `HOTEL` enum value from the `oneOf[#/components/schemas/CatalogsRetailItemsBatch]/catalog_type` response property for the response status `200` - removed the `RETAIL` enum value from the `oneOf[#/components/schemas/CatalogsCreativeAssetsItemsBatch]/catalog_type` response property for the response status `200` - removed the `RETAIL` enum value from the `oneOf[#/components/schemas/CatalogsHotelItemsBatch]/catalog_type` response property for the response status `200` - the response required property `oneOf[#/components/schemas/CatalogsRetailItemsBatch]/created_time` became not read-only for the status `200` - **2025-12-11** (v5) `79f62f71f05b`: 1 breaking, 1 info - the response property `oneOf[#/components/schemas/CatalogsRetailItemsBatch]/created_time` became nullable for the status `200` - the response property `oneOf[#/components/schemas/CatalogsRetailItemsBatch]/created_time` became required for the status `200` - **2025-04-04** (v5) `10f9eba4ad97`: 1 breaking, 2 info - added the pattern `^[a-zA-Z0-9]+$` to the `path` request parameter `batch_id` - api tag `catalog_items` added - api tag `catalogs` removed - **2024-08-14** (v5) `89c27ed39cfd`: 1 info - the endpoint scheme security `client_credentials` was added to the API - **2024-04-23** (v5) `f9321315766f`: 1 breaking, 5 warning, 1 info - added `#/components/schemas/CatalogsCreativeAssetsItemsBatch` to the response body `oneOf` list for the response status `200` - added the new `CREATIVE_ASSETS` enum value to the `catalog_type` response property for the response status `200` - added the new `CREATIVE_ASSETS` enum value to the `oneOf[#/components/schemas/CatalogsHotelItemsBatch]/catalog_type` response property for the response status `200` - added the new `CREATIVE_ASSETS` enum value to the `oneOf[#/components/schemas/CatalogsRetailItemsBatch]/catalog_type` response property for the response status `200` - added the new `FAILED` enum value to the `oneOf[#/components/schemas/CatalogsHotelItemsBatch]/status` response property for the response status `200` - added the new `FAILED` enum value to the `oneOf[#/components/schemas/CatalogsRetailItemsBatch]/status` response property for the response status `200` - added `CREATIVE_ASSETS` mapping keys to the response discriminator for the response status `200` - **2023-08-17** (v5) `0ff12596bafd`: 1 breaking, 5 warning, 2 info - added `#/components/schemas/CatalogsRetailItemsBatch, #/components/schemas/CatalogsHotelItemsBatch` to the response body `oneOf` list for the response status `200` - removed the optional property `batch_id` from the response with the `200` status - removed the optional property `completed_time` from the response with the `200` status - removed the optional property `created_time` from the response with the `200` status - removed the optional property `items` from the response with the `200` status - removed the optional property `status` from the response with the `200` status - added response discriminator for the response status `200` - added the required property `catalog_type` to the response with the `200` status - **2022-11-14** (v5) `e041d7b0cef0`: 2 info - added the new optional `query` request parameter `ad_account_id` - added the non-success response with the status `405` - **2022-04-12** (v5) `723c51158044`: 3 breaking, 6 info - added the new path request parameter `batch_id` - the `items/items/errors/items/` response's property type changed from no type to `object` for status `200` - the `items/items/warnings/items/` response's property type changed from no type to `object` for status `200` - added the optional property `items/items/errors/items/attribute` to the response with the `200` status - added the optional property `items/items/errors/items/code` to the response with the `200` status - added the optional property `items/items/errors/items/message` to the response with the `200` status - added the optional property `items/items/warnings/items/attribute` to the response with the `200` status - added the optional property `items/items/warnings/items/code` to the response with the `200` status - added the optional property `items/items/warnings/items/message` to the response with the `200` status - **2022-04-08** (v5) `33ec8e7421c7`: 2 breaking, 7 warning - the `items/items/errors/items/` response's property type changed from `object` to no type for status `200` - the `items/items/warnings/items/` response's property type changed from `object` to no type for status `200` - deleted the `path` request parameter `batch_id` - removed the optional property `items/items/errors/items/attribute` from the response with the `200` status - removed the optional property `items/items/errors/items/code` from the response with the `200` status - removed the optional property `items/items/errors/items/message` from the response with the `200` status - removed the optional property `items/items/warnings/items/attribute` from the response with the `200` status - removed the optional property `items/items/warnings/items/code` from the response with the `200` status - removed the optional property `items/items/warnings/items/message` from the response with the `200` status - **2022-04-08** (v5) `c561dee8c137`: 1 info - endpoint added --- [Operation](https://skmtc.dev/pinterest/apis/pinterest-rest-api/docs/catalogs/items/batch/:batch_id/get.md) - [API](https://skmtc.dev/pinterest/apis/pinterest-rest-api.md) - [Page](https://skmtc.dev/pinterest/apis/pinterest-rest-api/changes/catalogs/items/batch/:batch_id/get)