---
search:
  tags:
    - Sandboxes
    - GET
seo:
  description: >-
    Returns the file's bytes as they are, streamed. Reference for the GET
    /v1/sandboxes/{id}/files endpoint in the Ibby API.
sidebar:
  label: Read a file
  badge: GET
title: Read a file
type: openapi-operation
---
Returns the file's bytes as they are, streamed.

`GET /v1/sandboxes/{id}/files`

**Responses**

- `200` — The file's bytes.
- `400` — \`invalid\_request\`: The request does not match the contract.
- `401` — \`unauthorized\`: The API key is missing, unknown or revoked.
- `404` — \`not\_found\`: No such resource in this key's lane. Another lane's ids are not found either. \`file\_not\_found\`: The file to read does not exist.
- `409` — \`sandbox\_stopped\`: The sandbox has stopped: its lifetime or size limit was reached, or it was removed. \`in\_progress\`: A call with this \`Idempotency-Key\` is still running, or the sandbox is still being created. Retry later.
- `413` — \`file\_too\_large\`: The file is larger than \`max\_bytes\`, or than the 32 MiB ceiling.
- `500` — \`internal\_error\`: The platform failed. A retry may succeed; for a call that creates or writes, retry with the same Idempotency-Key.
- `503` — \`unavailable\`: A service behind the API could not be reached. Retry after a short wait; for a call that creates or writes, with the same Idempotency-Key.

Response example, 200:

```json
"string"
```