---
title: "Read a file's raw contents. Use this for direct data download."
method: GET
path: "/file/read"
---

# Read a file's raw contents. Use this for direct data download.

`GET /file/read`

id option:
  - Specifies the item's system ID to read.

type option:
  - Specifies content disposition or not.
  - 0: No content disposition. Returns raw binary file.
  - 1: Content disposition. May fix line endings to CR LF for text files.

bucket option:
  - Bucket is required.

name option:
  - Specify the name to save the file as (e.g document.pdf).

## Query parameters

- `id` string, required
- `type` 0 | 1 | 2 | 3 | 4, required
- `name` string
- `size` integer
- `storageid` string, required
- `systemid` string, required

## Response `200`

OK

## Other responses

- `404` — item was not found
- `503` — no storage server was available

## Changes

> 12 revisions in range; 1 could not be searched.

- **2025-11-25** `d120313f50a9` — 2 breaking, 5 info
  - the `query` request parameter `type` was restricted to a list of enum values
  - for the `query` request parameter `type`, the type/format was changed from `string`/`` to `integer`/``
  - added the new enum value `0.00` to the `query` request parameter `type`
  - added the new enum value `1.00` to the `query` request parameter `type`
  - …3 more
- **2025-11-19** `722b0ddb9ec4` — 1 info
  - endpoint added
- **2025-11-14** `218f8a8b8952` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/intelligencex/apis/intelx-io-search-api/changes/file/read/get.md)

---

[API](https://skmtc.dev/intelligencex/apis/intelx-io-search-api.md) · [All operations](https://skmtc.dev/intelligencex/apis/intelx-io-search-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/intelligencex/intelx-io-search-api/revisions/09fb9b26ddff/schema)