---
title: "List"
method: GET
path: "/data-clips"
tags: ["data-clips"]
---

# List

`GET /data-clips`

## Query parameters

- `spaceId` string — Space ID
- `sheetId` string — Sheet ID
- `status` string

## Headers

- `Authorization` string, required
- `X-Disable-Hooks` 'true', required

## Response `200`

Response with status 200

- TypeDataClipsListDataClipResponse
  - `data` TypeDataClipsDataClipResponse[], required
    - `data` TypeDataClipsDataClip, required
      - `id` string, required — Data Clip ID
      - `name` string, required — The name of the DataClip.
      - `description` string — A description of the DataClip.
      - `sourceSheetId` string, required — Sheet ID
      - `clipSheetId` string, required — Sheet ID
      - `workbookId` string, required — The ID of the workbook.
      - `status` string, required — The status of the DataClip.
      - `createdBy` string, required — The user who created the DataClip.
      - `mergedAt` string, date-time — The date when the DataClip was merged.
      - `deletedAt` string, date-time — The date when the DataClip was deleted.
      - `updatedAt` string, date-time, required — The date when the DataClip was updated.
      - `createdAt` string, date-time, required — The date when the DataClip was created.
      - `guestLinkUrl` string — A URL for guests to access the DataClip.
      - `accessToken` string — A signed token associated with the guest link.
      - `sharedLinkAccess` string — Indicates the shared link access level, public or restricted

## Other responses

- `400` — Error response with status 400
- `404` — Error response with status 404

---

[API](https://skmtc.net/flatfile/apis/api-reference.md) · [All operations](https://skmtc.net/flatfile/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/flatfile/api-reference/revisions/9d3a9979cd96/schema)