---
title: "Get a file"
method: GET
path: "/v1/files/{id}"
tags: ["files"]
---

# Get a file

`GET /v1/files/{id}`

## Request

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

Get a file's name, type, size, SHA-256 and status, without its bytes.

## Path parameters

- `id` string, required

## Response `200`

The file

- File
  - `id` string, required: a file ID: file_ and 32 lowercase hex digits
  - `name` string, required: The file's name, as given
  - `media_type` string, required: The file's media type, as checked
  - `size` number, nullable, required: Bytes: the declared size until the upload arrives, then the size received; null when none was declared
  - `sha256` string, nullable, required: The SHA-256 of the bytes, lowercase hex, once they arrived
  - `status` 'awaiting_upload' | 'ready' | 'in_use', required: awaiting_upload until its bytes arrive at upload_url, ready to pass to a run, in_use once a run took it
  - `direction` 'input' | 'output', required: input for a file sent to a run, output for one a run collected
  - `job_id` string, required: a job ID: job_ and 32 lowercase hex digits
  - `created_at` string, required: a string to be decoded into a Date
  - `expires_at` string, required: a string to be decoded into a Date

## Other responses

- `400`: invalid_request
- `401`: sign_in_required, unauthorized, reauthentication_required
- `403`: forbidden
- `404`: not_found
- `500`: internal_error
- `501`: not_configured
- `503`: temporarily_unavailable

---

[API](https://skmtc.dev/pomerado/apis/pomerado-api.md) · [All operations](https://skmtc.dev/pomerado/apis/pomerado-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pomerado/apis/pomerado-api/revisions/c07cea59691c?raw)