---
title: "Retrieve jobs"
method: GET
path: "/catalog-connector-jobs"
tags: ["Catalog Connector Jobs"]
---

# Retrieve jobs

`GET /catalog-connector-jobs`

## Request

- Base URL: `https://api.fabric.inc/v3`
- URL: `https://api.fabric.inc/v3/catalog-connector-jobs`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/fabric/apis/catalog-connector/docs/catalog-connector-jobs/get.ts> (a function with typed inputs; its response is checked against the schema)

Use this endpoint to retrieve a paginated list of import and export jobs related to Catalog Connector.
The following constraints apply when using the query parameters:
  - The query parameter job `ids` can't be combined with any other query parameters.
  - The query parameter `inputFileIds` can only be combined with the query parameter `lastJobOnly`. 
  - Pagination isn't supported when `ids` or `inputFileIds` is specified.

## Query parameters

- `ids` string
- `type` 'CATALOG_CONN_ITEM_VARIANT_IMPORT' | 'CATALOG_CONN_ITEM_VARIANT_EXPORT' | 'CATALOG_CONN_BUNDLE_IMPORT' | 'CATALOG_CONN_BUNDLE_EXPORT': Specify the type of operation or job performed by uploading the file.
- `inputFileIds` string
- `lastJobOnly` boolean
- `offset` integer
- `limit` integer

## Headers

- `x-fabric-tenant-id` string, required
- `x-fabric-request-id` string

## Response `200`

OK

- ProductJob: The details of the job.
  - `data` Job[]
    - `id` string: The 24-character system-generated file ID created using the [Create a File](/v3/api-reference/catalog-connector/files/create-file) endpoint.
    - `inputFileId` string: The IDs of the files to be processed as part of the job.
    - `outputFiles` string[]: The IDs of the processed files. The output files include success files, error files, and more.
    - `errorFiles` string[]: The IDs of the processed files. The output files include success files, error files, and more.
    - `progressTracker` object
      - `updatedAt` string: The time when the tracker was last updated, in UTC format.
      - `totalCount` integer: The total number of records to be processed through the job.
      - `processedCount` integer: The total number of records processed.
      - `errorCount` integer: Total number of records with error.
    - `status` 'IN_PROGRESS' | 'COMPLETED' | 'FAILED': The job status.
    - `statusMessage` string: A brief message corresponding to the job `status`.
    - `additionalDetails` object
      - `itemsCreated` integer: The number of items created during the import process. Only applicable when job `type` is `PRODUCT_IMPORT`.
      - `itemsUpdated` integer: The number of items updated during the import process. Only applicable when job `type` is `PRODUCT_IMPORT`.
    - `createdAt` string: The time of job creation, in UTC format.
    - `completedAt` string: The time of job completion, in UTC format.
    - `updatedBy` string: The email of the user who last updated the job.
    - `updatedAt` string: The time when the job was last updated, in UTC format.
  - `offset` integer: The number of records to skip before returning records. For example, when the offset is 20 and limit is 10, the system returns the records from 21 to 30.
  - `limit` integer: The maximum number of records per page.
  - `count` integer: The total number of records.

## Other responses

- `400`: Request is invalid or malformed
- `401`: The requester is unauthorized.
- `403`: The user isn't allowed to perform this action.
- `500`: Internal server error

---

[API](https://skmtc.dev/fabric/apis/catalog-connector.md) - [All operations](https://skmtc.dev/fabric/apis/catalog-connector/llms.txt) - [OpenAPI document](https://skmtc.dev/fabric/apis/catalog-connector/revisions/878ef9866561?raw)