---
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 scope: \`ingestion:manage\`

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

## Changes

> 71 revisions in range; 18 not diffed.

- **2026-04-02** `50de1d07d2f9` — 1 info
  - added the optional property `chunk_metadatas_count` to the response with the `200` status
- **2026-04-02** `8bc99b31eabf` — 2 breaking, 1 info
  - the response property `metadata` became nullable for the status `200`
  - the `metadata` response's property type changed from `object` to no type for status `200`
  - added `#/components/schemas/Metadata` to the `metadata` response property `allOf` list for the response status `200`
- **2026-04-01** `c1237a700168` — 1 info
  - added the optional property `chunk_metadata_keys` to the response with the `200` status
- **2026-03-10** `d28b7983ac23` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/qlonolink/apis/qaip-apis/changes/local-file-groups/:id/get.md)

---

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