---
title: "Get local file group"
method: GET
path: "/local-file-groups/{id}"
tags: ["local-file-groups"]
---

# Get local file group

`GET /local-file-groups/{id}`

Returns a single local file group by ID.

Required roles: All

## Path parameters

- `id` string, required

## Response `200`

Successful retrieval of local file group

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

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `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)