---
title: "Get a Connector's reported files"
method: GET
path: "/v1/data-acquisition/connectors/{id}/files"
tags: ["Connectors"]
---

# Get a Connector's reported files

`GET /v1/data-acquisition/connectors/{id}/files`

## Request

- Base URL: `https://api.tetrascience.com`
- URL: `https://api.tetrascience.com/v1/data-acquisition/connectors/{id}/files`
- Auth: API key in header `ts-auth-token` and API key in header `x-org-slug`

**:warning: This is a new API which is still subject to change.**

Use this endpoint to get metadata about the files reported by a Connector, including those that have not yet been uploaded or that have failed.

## Path parameters

- `id` string, required

## Query parameters

- `fileIds` string[]
- `excludeFileIds` string[]
- `uniqueExternalIds` string[]
- `excludeUniqueExternalIds` string[]
- `statuses` string[]
- `maxErrors` number
- `createdBefore` string, date-time
- `createdAfter` string, date-time
- `updatedBefore` string, date-time
- `updatedAfter` string, date-time
- `orderBy` 'filepath' | 'status' | 'errorCount' | 'updatedAt' | 'createdAt'
- `orderDirection` 'ASC' | 'DESC'
- `take` number
- `skip` number

## Response `200`

Successful response with a list of files reported by a Connector

- ConnectorFilesResponse: A list of files reported by a Connector.
  - `files` ConnectorFileDto[], required
    - `id` string, required: The file's id.
    - `uniqueExternalId` string, required: The file's unique external id, used by Connectors to deduplicate external files.
    - `filepath` string, required: The file's path.
    - `status` 'PENDING' | 'PROCESSING' | 'SKIPPED' | 'SUCCESS' | 'ERROR', required: The file's status, as reported by the Connector. This reflects the Connector's own workflow to upload files, not the platform's processing of those files.
    - `metadata` object, required
    - `errorCount` number, required: The number of times the file has errored during upload. After 5 errors, the Connector will stop attempting to retry this file.
    - `errorMessage` string: The last error message reported by the Connector for this file.
    - `updatedAt` string, date-time, required: The last time the file's details were updated.
    - `createdAt` string, date-time, required: The time the file was created.
  - `total` number, required

---

[API](https://skmtc.dev/tetrascience/apis/hubs-connectors.md) - [All operations](https://skmtc.dev/tetrascience/apis/hubs-connectors/llms.txt) - [OpenAPI document](https://skmtc.dev/tetrascience/apis/hubs-connectors/revisions/efd351718bc7?raw)