- Getting Started
- Data Ingestion
- Use Cases
Product Catalog User Guides
- Overview
- List
- Attributes
- Categories
- Collections
- Background Jobs
- Settings
Product Catalog API
- Overview
- API Authentication and Data Sync
- Attributes & Attribute Mapping
- Categories
- Products
- Collections
- Background Jobs
- Get List of Jobs
- Get List of Files
- Download Files
- POSTCancel Background Jobs Using Job IDs
- Bulk Import & Export
- Published Products
Developer Guide
Catalog Connector User Guides
- Overview
- Items
- Bundles
Catalog Connector API
- Files
- Jobs
- Operations
Search Jobs
Get a paginated list of jobs related to products and collections by specifying the request body. You need to specify the criteria for the search such as job id
, type
, status
, collectionId
, inputFileId
.
curl --request POST \
--url https://api.fabric.inc/v3/product-jobs/search \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"sort": "+id,-type",
"match": {
"id": {
"op": "IN",
"value": [
"5fc100f1dd0c5900750c04b1"
]
},
"inputFileId": {
"op": "IN",
"value": [
"5fc100f1dd0c5900750c04b1"
]
},
"name": {
"op": "IN",
"value": [
"blue"
]
},
"keyword": {
"op": "CONTAINS",
"value": "blue"
},
"type": {
"op": "IN",
"value": [
"ITEM_VARIANT_EXPORT"
]
},
"status": {
"op": "IN",
"value": [
"COMPLETED"
]
},
"createdAt": {
"op": "RANGE",
"fromValue": "2022-04-20T10:24:36.162Z",
"toValue": "2023-04-20T10:24:36.162Z"
},
"completedAt": {
"op": "RANGE",
"fromValue": "2022-04-20T10:24:36.162Z",
"toValue": "2023-04-20T10:24:36.162Z"
}
},
"offset": 2,
"limit": 10
}'
{
"data": [
{
"id": "877f1f77bcf86cd799439087",
"type": "ITEM_VARIANT_EXPORT",
"inputFileId": "327f1f77bcf86cd799439045",
"outputFiles": [
"507f1f77bcf86cd7994390163, 967f1f77bcf86cd799439058"
],
"errorFiles": [
"887f1f77bcf86cd799439011, 997f1f77bcf86cd799439074"
],
"progressTracker": {
"updatedAt": "2023-02-14T22:10:30.618Z",
"totalCount": 100000,
"processedCount": 40000,
"errorCount": 10
},
"status": "COMPLETED",
"statusMessage": "100% completed",
"additionalDetails": {
"itemsCreated": 10,
"itemsUpdated": 10,
"variantsCreated": 10,
"variantsUpdated": 10,
"bundlesCreated": 10,
"bundlesUpdated": 10,
"attributeCreated": 10,
"attributeUpdated": 10,
"categoriesCreated": 10,
"categoriesUpdated": 10,
"collectionCreated": 5,
"collectionUpdated": 10
},
"createdAt": "2021-09-14T22:10:30.618Z",
"completedAt": "2021-09-14T22:10:30.618Z",
"updatedBy": "test@email.com",
"updatedAt": "2021-09-14T22:10:30.618Z"
}
],
"offset": 5,
"limit": 10,
"count": 100
}
Authorizations
S2S access token (JWT) from fabric Identity service (during login)
Headers
A header used by fabric to identify the tenant making the request. You must include tenant id in the authentication header for an API request to access any of fabric’s endpoints. You can retrieve the tenant id , which is also called account id, from Copilot. This header is required.
"517fa9dfd42d8b00g1o3k312"
Unique request ID
"263e731c-45c8-11ed-b878-0242ac120002"
Body
Request for a job search.
Search criteria to match jobs.
Search based on job type
Operations that can be performed on a string
type
IN
"IN"
Supported job types
ITEM_VARIANT_EXPORT
, ITEM_VARIANT_IMPORT
, BUNDLE_EXPORT
, BUNDLE_IMPORT
, ATTRIBUTE_IMPORT
, ATTRIBUTE_EXPORT
, CATEGORY_IMPORT
, CATEGORY_EXPORT
, COLLECTION_IMPORT
, COLLECTION_EXPORT
, ATTRIBUTE_JOB
, PRODUCT_JOB
, CATEGORY_JOB
, COLLECTION_JOB
, PRODUCT_BULK_CATEGORY_UPDATE
, PRODUCT_DENORM_JOB
Search based on job status
Operations that can be performed on a string
type
IN
"IN"
Job status
SCHEDULED
, COMPLETED_PARTIALLY
, IN_PROGRESS
, COMPLETED
, FAILED
, UPDATING_SEARCH_INDEX
, CANCELLATION_IN_PROGRESS
, CANCELLED
Search based on job creation time
Search operation performed on a date range
RANGE
"RANGE"
Starting range (UTC)
"2022-04-20T10:24:36.162Z"
Ending range (UTC)
"2023-04-20T10:24:36.162Z"
Search based on job completion Time
Search operation performed on a date range
RANGE
"RANGE"
Starting range (UTC)
"2022-04-20T10:24:36.162Z"
Ending range (UTC)
"2023-04-20T10:24:36.162Z"
Sorting criteria. Sorting is supported on id
, type
, status
, completedAt
and createdAt
. -
refers to descending while +
refers to ascending order.
"+id,-type"
Number of records to skip before returning records. For example, offset=20, limit=10
returns records 21-30.
2
Maximum number of records per page
10
Response
Details of jobs
Job details
24-character system-generated job ID
"877f1f77bcf86cd799439087"
Supported job types
ITEM_VARIANT_EXPORT
, ITEM_VARIANT_IMPORT
, BUNDLE_EXPORT
, BUNDLE_IMPORT
, ATTRIBUTE_IMPORT
, ATTRIBUTE_EXPORT
, CATEGORY_IMPORT
, CATEGORY_EXPORT
, COLLECTION_IMPORT
, COLLECTION_EXPORT
, ATTRIBUTE_JOB
, PRODUCT_JOB
, CATEGORY_JOB
, COLLECTION_JOB
, PRODUCT_BULK_CATEGORY_UPDATE
, PRODUCT_DENORM_JOB
"ITEM_VARIANT_EXPORT"
File ID that needs to be processed through the job
"327f1f77bcf86cd799439045"
Output file IDs. For import and export jobs, the output files show the exported products (items, variant and/or bundle) based on the job type.
File IDs that show error details of the products that couldn't be imported or exported.
Time of last update to tracker (UTC)
"2023-02-14T22:10:30.618Z"
Total number of records to be processed through the job
100000
Total number of records to be processed
40000
Total number of errors
10
Job status
SCHEDULED
, COMPLETED_PARTIALLY
, IN_PROGRESS
, COMPLETED
, FAILED
, UPDATING_SEARCH_INDEX
, CANCELLATION_IN_PROGRESS
, CANCELLED
"COMPLETED"
User-friendly message corresponding to the current job status
"100% completed"
Number of items created. Only applicable when the job type
is ITEM_VARIANT_IMPORT
.
10
Number of items updated. Only applicable when the job type
is ITEM_VARIANT_IMPORT
.
10
Number of variants created. Only applicable when the job type
is ITEM_VARIANT_IMPORT
.
10
Number of variants updated. Only applicable when the job type
is ITEM_VARIANT_IMPORT
.
10
Number of bundles created. Only applicable when the job type
is BUNDLE_IMPORT
.
10
Number of bundles updated. Only applicable when the job type
is BUNDLE_IMPORT
.
10
Number of attributes created. Only applicable when the job type
is ATTRIBUTE_IMPORT
.
10
Number of attributes updated. Only applicable when the job type
is ATTRIBUTE_IMPORT
.
10
Number of categories created. Only applicable when the job type
- CATEGORY_IMPORT
.
10
Number of categories updated. Only applicable when the job type
is CATEGORY_IMPORT
.
10
Number of collections created. Only applicable when the job type
is COLLECTION_IMPORT
.
5
Number of collections updated. Only applicable when the job type
is COLLECTION_IMPORT
.
10
Time of job creation (UTC)
"2021-09-14T22:10:30.618Z"
Time of job completion (UTC)
"2021-09-14T22:10:30.618Z"
Email of the user who last updated the job
"test@email.com"
Time of last update to job (UTC)
"2021-09-14T22:10:30.618Z"
Number of records to skip before returning records. For example, offset=20, limit=10
returns records 21-30.
5
Maximum number of records per page
10
Total number of records
100
Was this page helpful?
curl --request POST \
--url https://api.fabric.inc/v3/product-jobs/search \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"sort": "+id,-type",
"match": {
"id": {
"op": "IN",
"value": [
"5fc100f1dd0c5900750c04b1"
]
},
"inputFileId": {
"op": "IN",
"value": [
"5fc100f1dd0c5900750c04b1"
]
},
"name": {
"op": "IN",
"value": [
"blue"
]
},
"keyword": {
"op": "CONTAINS",
"value": "blue"
},
"type": {
"op": "IN",
"value": [
"ITEM_VARIANT_EXPORT"
]
},
"status": {
"op": "IN",
"value": [
"COMPLETED"
]
},
"createdAt": {
"op": "RANGE",
"fromValue": "2022-04-20T10:24:36.162Z",
"toValue": "2023-04-20T10:24:36.162Z"
},
"completedAt": {
"op": "RANGE",
"fromValue": "2022-04-20T10:24:36.162Z",
"toValue": "2023-04-20T10:24:36.162Z"
}
},
"offset": 2,
"limit": 10
}'
{
"data": [
{
"id": "877f1f77bcf86cd799439087",
"type": "ITEM_VARIANT_EXPORT",
"inputFileId": "327f1f77bcf86cd799439045",
"outputFiles": [
"507f1f77bcf86cd7994390163, 967f1f77bcf86cd799439058"
],
"errorFiles": [
"887f1f77bcf86cd799439011, 997f1f77bcf86cd799439074"
],
"progressTracker": {
"updatedAt": "2023-02-14T22:10:30.618Z",
"totalCount": 100000,
"processedCount": 40000,
"errorCount": 10
},
"status": "COMPLETED",
"statusMessage": "100% completed",
"additionalDetails": {
"itemsCreated": 10,
"itemsUpdated": 10,
"variantsCreated": 10,
"variantsUpdated": 10,
"bundlesCreated": 10,
"bundlesUpdated": 10,
"attributeCreated": 10,
"attributeUpdated": 10,
"categoriesCreated": 10,
"categoriesUpdated": 10,
"collectionCreated": 5,
"collectionUpdated": 10
},
"createdAt": "2021-09-14T22:10:30.618Z",
"completedAt": "2021-09-14T22:10:30.618Z",
"updatedBy": "test@email.com",
"updatedAt": "2021-09-14T22:10:30.618Z"
}
],
"offset": 5,
"limit": 10,
"count": 100
}