---
title: "List files shared from a response sandbox"
method: GET
path: "/v1/responses/{response_id}/files"
tags: ["Responses"]
---

# List files shared from a response sandbox

`GET /v1/responses/{response_id}/files`

Lists the files the model delivered via the share_file tool during this response.

## Path parameters

- `response_id` string, required

## Response `200`

The list of shared files.

- ResponseFileList
  - `object` 'list', required — Object type. Always `list`.
  - `data` ResponseFile[], required
    - `id` string, required — File identifier, scoped to the parent response.
    - `object` 'file', required — Object type. Always `file`.
    - `filename` string, required — Original filename set by the share_file tool call.
    - `bytes` integer, required — Size of the file in bytes.
    - `created_at` integer, required — Unix timestamp (seconds) when the file was produced.

## Other responses

- `404` — Response not found.

## Changes

- **2026-06-08** `dceeb8fc9f53` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/perplexityai/apis/perplexity-ai-api/changes/v1/responses/:response_id/files/get.md)

---

[API](https://skmtc.dev/perplexityai/apis/perplexity-ai-api.md) · [All operations](https://skmtc.dev/perplexityai/apis/perplexity-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/perplexityai/perplexity-ai-api/revisions/bcca72d3b564/schema)