---
title: "Retrieve import and export history"
method: GET
path: "/catalog-connector-files"
tags: ["Catalog Connector Files"]
---

# Retrieve import and export history

`GET /catalog-connector-files`

## Request

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

Use this endpoint to access files previously imported to or exported from the Catalog Connector, sorted in chronological order. You can refine the search results by using the following query parameters:
- `ids`: Provide a comma-separated list of file IDs to retrieve multiple files by their IDs. Note that pagination isn't supported when using this parameter.
- Format type (`formatType`) :  Specify the format of the file to filter files by format. The options are **CSV** or **JSONL**.
- Operation type (`type`): Use this parameter to specify whether you want imported or exported files.
- Pagination (`offset`, `limit`):  Use offset and limit parameters to refine the number of results returned.
- `sort`:  Use this parameter to view results in ascending or descending order.
If no query parameters are specified, the endpoint returns up to 10 records.

## Query parameters

- `ids` string
- `fileName` string
- `formatType` 'csv' | 'jsonl': Specify the file format used to upload to Catalog Connector.
- `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.
- `offset` integer
- `limit` integer
- `sort` string

## Headers

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

## Response `200`

OK

- GetFilesResponse: The response of the `Retrieve import or export history` request, along with pagination data.
  - `data` CommonFileSchema[]
    - `id` string: The 24-character system-generated file ID created using the [Create a File](/v3/api-reference/catalog-connector/files/create-file) endpoint.
    - `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.
    - `name` string: The name of the file to be uploaded to the AWS S3 location.
    - `locale` string: The language code, which is a combination of language (ISO 639 format) and country (ISO 3166 format). The default value is `en-US`.
    - `formatType` 'csv' | 'jsonl': Specify the file format used to upload to Catalog Connector.
    - `createdAt` string: The time of file creation, in UTC format.
    - `updatedBy` string: The email of the user who last updated the file.
    - `updatedAt` string: The time of last update to the file, 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)