# List Product Catalog Imports Returns a list of ProductCatalogImport objects. ## Parameters - `created` (timestamp, optional) Filter for objects created at the specified timestamp. Must be an RFC 3339 date & time value, for example: 2022-09-18T13:22:00Z. - `created_gt` (timestamp, optional) Filter for objects created after the specified timestamp. Must be an RFC 3339 date & time value, for example: 2022-09-18T13:22:00Z. - `created_gte` (timestamp, optional) Filter for objects created on or after the specified timestamp. Must be an RFC 3339 date & time value, for example: 2022-09-18T13:22:00Z. - `created_lt` (timestamp, optional) Filter for objects created before the specified timestamp. Must be an RFC 3339 date & time value, for example: 2022-09-18T13:22:00Z. - `created_lte` (timestamp, optional) Filter for objects created on or before the specified timestamp. Must be an RFC 3339 date & time value, for example: 2022-09-18T13:22:00Z. - `feed_type` (enum, optional) Filter by the type of feed data being imported. Possible enum values: - `inventory` Inventory levels and stock availability feed. - `pricing` Pricing information feed including costs and currency data. - `product` Product information feed including SKUs, descriptions, and attributes. - `limit` (integer, optional) The maximum number of results per page. - `page` (string, optional) The page token. - `status` (enum, optional) Filter by import status. Possible enum values: - `awaiting_upload` The import is waiting for the file to be uploaded. - `failed` The import failed and no records were processed. - `processing` The import is processing the uploaded file. - `succeeded` The import completed successfully with all records processed. - `succeeded_with_errors` The import completed but some records failed to process. ## Returns ## Response attributes - `data` (array of objects) List of ProductCatalogImport objects. - `data.id` (string) The unique identifier for this ProductCatalogImport. - `data.object` (string, value is "v2.commerce.product_catalog_import") String representing the object’s type. Objects of the same type share the same value of the object field. - `data.created` (timestamp) The time this ProductCatalogImport was created. - `data.feed_type` (enum) The type of feed data being imported into the product catalog. Possible enum values: - `inventory` Inventory levels and stock availability feed. - `pricing` Pricing information feed including costs and currency data. - `product` Product information feed including SKUs, descriptions, and attributes. - `data.livemode` (boolean) Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode. - `data.metadata` (map) Additional information about the object in a structured format. - `data.status` (enum) The current status of this ProductCatalogImport. Possible enum values: - `awaiting_upload` The import is waiting for the file to be uploaded. - `failed` The import failed and no records were processed. - `processing` The import is processing the uploaded file. - `succeeded` The import completed successfully with all records processed. - `succeeded_with_errors` The import completed but some records failed to process. - `data.status_details` (object, nullable) Details about the current import status. - `data.status_details.awaiting_upload` (object, nullable) Details when the import is awaiting file upload. - `data.status_details.awaiting_upload.upload_url` (object) The pre-signed URL information for uploading the catalog file. - `data.status_details.awaiting_upload.upload_url.expires_at` (timestamp) The timestamp when the upload URL expires. - `data.status_details.awaiting_upload.upload_url.url` (string) The pre-signed URL for uploading the catalog file. - `data.status_details.failed` (object, nullable) Details when the import didn’t complete. - `data.status_details.failed.code` (enum) The error code for this product catalog processing failure. Possible enum values: - `file_not_found` Stripe couldn’t find the import file or it wasn’t uploaded within the required time window. - `internal_error` An internal error occurred during import processing. - `invalid_file` Stripe couldn’t process the uploaded file due to parsing errors. - `data.status_details.failed.failure_message` (string) A message explaining why the import failed. - `data.status_details.failed.type` (enum) The error type for this product catalog processing failure. Possible enum values: - `cannot_proceed` The import can’t proceed and requires user action. - `transient_failure` The import failed due to a transient error and might succeed if retried. - `data.status_details.processing` (object, nullable) Details when the import is processing. - `data.status_details.processing.error_count` (int64) The number of records that failed to process so far. - `data.status_details.processing.success_count` (int64) The number of records processed so far. - `data.status_details.succeeded` (object, nullable) Details when the import has succeeded. - `data.status_details.succeeded.success_count` (int64) The total number of records processed. - `data.status_details.succeeded_with_errors` (object, nullable) Details when the import completed but some records failed to process. - `data.status_details.succeeded_with_errors.error_count` (int64) The total number of records that failed to process. - `data.status_details.succeeded_with_errors.error_file` (object) A file containing details about all errors that occurred. - `data.status_details.succeeded_with_errors.error_file.content_type` (string) The MIME type of the error file. - `data.status_details.succeeded_with_errors.error_file.download_url` (object) The pre-signed URL information for downloading the error file. - `data.status_details.succeeded_with_errors.error_file.download_url.expires_at` (timestamp) The timestamp when the download URL expires. - `data.status_details.succeeded_with_errors.error_file.download_url.url` (string) The pre-signed URL for downloading the error file. - `data.status_details.succeeded_with_errors.error_file.size` (int64) The size of the error file in bytes. - `data.status_details.succeeded_with_errors.samples` (array of objects) A sample of errors that occurred during processing. - `data.status_details.succeeded_with_errors.samples.id` (string) The identifier of the record that failed to process. - `data.status_details.succeeded_with_errors.samples.error_message` (string) A description of what went wrong with this record. - `data.status_details.succeeded_with_errors.samples.field` (string) The name of the field that caused the error. - `data.status_details.succeeded_with_errors.samples.row` (int64) The row number in the import file where the error occurred. - `data.status_details.succeeded_with_errors.success_count` (int64) The total number of records processed. - `next_page_url` (string, nullable) URL to fetch the next page of the list. If there are no more pages, the value is null. - `previous_page_url` (string, nullable) URL to fetch the previous page of the list. If there are no previous pages, the value is null. ```curl curl https://api.stripe.com/v2/commerce/product_catalog/imports \ -H "Authorization: Bearer <>" \ -H "Stripe-Version: 2026-04-22.dahlia" ``` ### Response ```json { "object": "v2.list", "data": [ { "id": "pcimprt_test_61THl3VA5Zt5cTqbP16T9R4DRrSQbEWmWeLUx7WmOR8K", "object": "v2.commerce.product_catalog_import", "status": "awaiting_upload", "created": "2026-01-01T00:00:00.000Z", "status_details": { "awaiting_upload": { "upload_url": { "url": "https://stripeusercontent.com/files/us-west-2/upload/wksp_b1H", "expires_at": "2026-01-01T01:00:00.000Z" } } }, "metadata": { "batch_id": "31234" } } ], "next_page_url": null, "previous_page_url": null } ```