---
title: "Batch get files by IDs"
method: POST
path: "/files/queries"
tags: ["Files"]
---

# Batch get files by IDs

`POST /files/queries`

## Request body

- object
  - `fileIds` string[], required

## Response `200`

OK

- ApiResponseBatchGetFiles
  - `success` boolean, required
  - `message` string, nullable
  - `timestamp` string, date-time, required
  - `data` BatchGetFiles
    - `total` integer, required
    - `success` integer, required
    - `files` FileDetail[], required
      - `file` File, required
        - `id` string
        - `name` string, nullable
        - `size` integer, nullable
        - `fileType` string, nullable
        - `userId` string, nullable
        - `createdAt` string, date-time, nullable
        - `updatedAt` string, date-time, nullable
      - `parsed` FileParse
        - `fileId` string
        - `name` string
        - `fileType` string
        - `parseStatus` 'completed' | 'failed'
        - `parsedAt` string, date-time, nullable
        - `content` string, nullable
        - `error` string, nullable
        - `metadata` object
          - `pages` integer, nullable
          - `title` string, nullable
          - `totalCharCount` integer, nullable
          - `totalLineCount` integer, nullable
    - `failed` object[], required
      - `fileId` string, required
      - `error` string, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/lobehub/apis/lobechat-openapi.md) · [All operations](https://skmtc.net/lobehub/apis/lobechat-openapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lobehub/lobechat-openapi/versions/7be2ebcf191c/schema)