---
title: "Retrieve file metadata"
method: GET
path: "/files/{id}"
tags: ["Files"]
---

# Retrieve file metadata

`GET /files/{id}`

Retrieve the metadata for a single uploaded data file.

## Path parameters

- `id` string, required — The ID of the file to retrieve

## Response `200`

File retrieved successfully

- FileResponse — Structured information describing a file uploaded to Together.
  - `id` string, required — ID of the file.
  - `object` 'file', required — The object type, which is always `file`.
  - `created_at` integer, required — The timestamp when the file was created.
  - `filename` string, required — The name of the file as it was uploaded.
  - `bytes` integer, required — The number of bytes in the file.
  - `purpose` 'fine-tune' | 'eval' | 'batch-api', required — The purpose of the file
  - `Processed` boolean, required — Deprecated. Whether file has been fully uploaded.
  - `FileType` 'csv' | 'jsonl' | 'parquet', required — The type of the file
  - `processing_status` 'PENDING' | 'QUEUED' | 'RUNNING' | 'COMPLETED' | 'FAILED' | 'INVALID_FORMAT' — Lifecycle state of a file in the validation pipeline. The typical progression is `PENDING` → `QUEUED` → `RUNNING` → `COMPLETED` / `FAILED`. `INVALID_FORMAT` is a terminal state for files whose contents failed validation in a user-correctable way.
  - `validation_report` FileValidationReport — Validation outcome for a fine-tune training file, produced by the file validation pipeline.
    - `valid` boolean, required — Whether the file passed validation.
    - `dataset_format` string — Detected dataset format (e.g. `CONVERSATION`, `INSTRUCTION`).
    - `dataset_has_sample_weights` boolean — Whether the dataset carries per-sample weights.
    - `dataset_has_message_weights` boolean — Whether the dataset carries per-message weights (only possible for `CONVERSATION` format).
    - `dataset_is_multimodal` boolean — Whether the dataset contains multimodal content.
    - `dataset_has_tools` boolean — Whether the dataset contains tool-use messages.
    - `dataset_has_parallel_tool_calls` boolean — Whether the dataset contains parallel tool-use messages.
    - `dataset_has_reasoning` boolean — Whether the dataset contains reasoning content.
    - `nlines` integer — Number of lines (records) in the dataset.
    - `file_id` string — ID of the file this report describes.
    - `error_type` 'INVALID_FORMAT' — Category of validation failure.
    - `error` string — Human-readable validation error message. Only present when `error_type` is set (i.e. user-correctable failures).

---

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