---
title: "List local file groups"
method: GET
path: "/local-file-groups"
tags: ["local-file-groups"]
---

# List local file groups

`GET /local-file-groups`

Lists local file groups with cursor-based pagination.

Required roles: All

## Query parameters

- `limit` integer
- `after_id` string, uuid

## Response `200`

Successful retrieval of local file groups

- ListLocalFileGroupsResponse
  - `local_file_groups` LocalFileGroup[], required
    - `id` string, required — Local file group ID
    - `name` string, required — Local file group name
    - `status` 'unknown' | 'queued' | 'not_started' | 'managed' | 'starting' | 'started' | 'success' | 'failure' | 'canceling' | 'canceled' | 'deleting' | 'delete_job_failure', required — Job status
    - `upload_time` integer — Upload time (Unix timestamp in seconds)
    - `creation_time` integer — Creation time (Unix timestamp in seconds)
    - `start_time` integer — Start time (Unix timestamp in seconds)
    - `end_time` integer — End time (Unix timestamp in seconds)
    - `error` JobError, nullable
      - `title` string — Error title
      - `message` string — Error message
    - `metadata` Metadata
      - `records` MetadataRecord[] — List of metadata records. A patch may contain up to 40 items; the merged result is capped at 20.
        - `key` string, required — Metadata key (max 20 characters)
        - `val` unknown, required
        - `type` 'string' | 'integer' | 'float' | 'date' | 'datetime' — Data type of the metadata value
    - `chunk_metadata_keys` ChunkMetadataKeyConfig[] — Chunk metadata key configurations
      - `key` string, required — Metadata key name
      - `type` 'string' | 'integer' | 'float' | 'date' | 'datetime', required — Data type of the metadata value
    - `chunk_metadatas_count` integer — Number of chunk metadata records extracted for this local file group
  - `pagination` Pagination, required
    - `total` integer — Total number of items
    - `limit` integer, required — Maximum number of items per page
    - `has_more` boolean, required — Whether there are more items after this page
    - `next_id` string, uuid, nullable — ID to pass as after_id for next page (null if has_more=false)

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.net/qlonolink/apis/qaip-apis.md) · [All operations](https://skmtc.net/qlonolink/apis/qaip-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/qlonolink/qaip-apis/revisions/f5f5994dfe05/schema)