---
search:
  tags:
    - Sandboxes
    - GET
seo:
  description: >-
    List a directory. Reference for the GET /v1/sandboxes/{id}/files/list
    endpoint in the Ibby API.
sidebar:
  label: List a directory
  badge: GET
title: List a directory
type: openapi-operation
---
`GET /v1/sandboxes/{id}/files/list`

**Responses**

- `200` — The listing.
- `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.
- `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.
- `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
{
  "entries": [
    {
      "path": "string",
      "size_bytes": 0,
      "type": "file"
    }
  ],
  "truncated": true
}
```