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

# Retrieve file metadata

`GET /v1/files/{id}`

## Request

- Base URL: `https://api.together.ai`
- URL: `https://api.together.ai/v1/files/{id}`
- Auth: HTTP bearer

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' | 'calibration' | 'eval' | 'batch-api', required: The purpose of the file
  - `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 or calibration 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).

## Changes

- **2026-10-22** `bb5257b3173a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/together/apis/together-apis/changes/v1/files/:id/get.md)

---

[API](https://skmtc.dev/together/apis/together-apis.md) - [All operations](https://skmtc.dev/together/apis/together-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/together/apis/together-apis/revisions/93438ddac711?raw)