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

# List sources

`GET /sources`

Lists sources that have metadata records. Currently only local\_file sources are returned by this endpoint. Crawl source IDs appear in search results and can be used with GET /sources/{source\_id}/raw instead.

Required roles: All, App

## Query parameters

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

## Response `200`

Successful retrieval of sources

- ListSourcesResponse
  - `sources` Source[], required
    - `id` string, required — Source ID (file ID)
    - `source_group_id` string, required — Parent source group ID
    - `name` string, required — Name of the source (file name)
    - `file_type` 'html' | 'pdf' | 'ppt' | 'pptx' | 'pptm' | 'doc' | 'docx' | 'docm' | 'xls' | 'xlsx' | 'xlsm' | 'md' | 'txt' | 'jsonl' | 'png' | 'jpg' | 'webp' | 'heic' | 'heif' | 'wav' | 'mp3' | 'aiff' | 'aac' | 'm4a' | 'ogg' | 'flac' | 'mp4' | 'mpg' | 'mov' | 'avi' | 'flv' | 'webm' | 'wmv' | '3gp' | 'notion_page' — The type of the source file
    - `file_size` integer — File size in bytes
    - `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
  - `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)