---
title: "Get file contents"
method: GET
path: "/api/file/{DirName}/**"
tags: ["file"]
---

# Get file contents

`GET /api/file/{DirName}/**`

Downloads the specified file from a media directory.

## Query parameters

- `tail` integer
- `play` boolean
- `attach` boolean

## Response `200`

File contents; content type varies by file extension and query params

## Other responses

- `404` — File not found

## Changes

- **2026-05-14** `5ae08fa1c880` — 5 info
  - added the new optional `query` request parameter `attach`
  - added the new optional `query` request parameter `play`
  - added the new optional `query` request parameter `tail`
  - added the media type `application/octet-stream` for the response with the status `200`
  - …1 more
- **2026-05-13** `34a577bdabff` — 2 breaking, 3 warning
  - removed the media type `application/octet-stream` for the response with the status `200`
  - removed the media type `text/plain` for the response with the status `404`
  - deleted the `query` request parameter `attach`
  - deleted the `query` request parameter `play`
  - …1 more

[Change history](https://skmtc.dev/falconchristmas/apis/fpp-api/changes/api/file/:DirName/**/get.md)

---

[API](https://skmtc.dev/falconchristmas/apis/fpp-api.md) · [All operations](https://skmtc.dev/falconchristmas/apis/fpp-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/falconchristmas/fpp-api/revisions/2d744b175449/schema)