---
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`

**: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.net/tetrascience/apis/tetra-data-lake.md) · [All operations](https://skmtc.net/tetrascience/apis/tetra-data-lake/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tetrascience/tetra-data-lake/revisions/0205e2bace53/schema)