---
title: "List files in a batch"
method: GET
path: "/v2/batches/{batch_id}/files"
tags: ["batches"]
---

# List files in a batch

`GET /v2/batches/{batch_id}/files`

Return a list of files in a batch.

## Path parameters

- `batch_id` integer, required

## Query parameters

- `page_size` integer
- `start_token` string

## Headers

- `Authorization` string, required
- `IB-Context` string

## Response `200`

Request successful.

- ListBatchFilesResponse
  - `nodes` ListBatchFilesResponseNodesItems[] — List of files in the batch.
    - `full_path` string — Complete path to the file in the storage system.
    - `metadata` ListBatchFilesResponseNodesItemsMetadata — Metadata information about the file.
      - `node_type` string — Type of the node (e.g., 'file').
      - `size` integer — Size of the file in bytes.
      - `modified_timestamp` integer — Last modification timestamp of the file, in Unix time seconds.
    - `perms` ListBatchFilesResponseNodesItemsPerms — Permission settings for the file.
      - `can_read` boolean — Whether the user has read permission.
      - `can_write` boolean — Whether the user has write permission.
      - `can_delete` boolean — Whether the user has delete permission.
    - `name` string — Name of the file, including optional extension.
  - `next_page_token` string — Token for retrieving the next page of results.
  - `has_more` boolean — Indicates whether there are more files to be retrieved.

## Other responses

- `404` — Batch does not exist, or denied access.

---

[API](https://skmtc.net/instabase/apis/api-reference.md) · [All operations](https://skmtc.net/instabase/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/instabase/api-reference/revisions/3a4f46d48141/schema)