---
title: "Check file information"
method: HEAD
path: "/files/{id}"
tags: ["files"]
---

# Check file information

`HEAD /files/{id}`

Retrieve file metadata headers without downloading the file content. Supports conditional requests and provides caching information.

## Path parameters

- `id` string, required

## Query parameters

- `q` integer
- `h` integer
- `w` integer
- `b` number
- `f` 'auto' | 'same' | 'jpeg' | 'webp' | 'png' | 'avif' | 'heic' — Output format for image files. Use 'auto' for content negotiation based on Accept header

## Headers

- `if-match` string
- `if-none-match` string
- `if-modified-since` string — Date in RFC 2822 format
- `if-unmodified-since` string — Date in RFC 2822 format

## Response `200`

File information headers retrieved successfully

## Other responses

- `304` — File not modified since the condition specified in If-Modified-Since or If-None-Match headers
- `412` — Precondition failed for conditional request headers (If-Match, If-Unmodified-Since)
- `default` — Error occurred

## Changes

- **2025-11-19** `03a69e06fb94` — 1 info
  - added the new enum value `heic` to the `query` request parameter `f`
- **2025-09-25** `86f040df2264` — 1 breaking
  - removed the enum value `heic` from the `query` request parameter `f`

[Change history](https://skmtc.dev/nhost/apis/nhost-storage-api/changes/files/:id/head.md)

---

[API](https://skmtc.dev/nhost/apis/nhost-storage-api.md) · [All operations](https://skmtc.dev/nhost/apis/nhost-storage-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nhost/nhost-storage-api/revisions/97295913b74e/schema)