---
title: "Download a binary file from an actor's output (e.g. a captured image)"
method: GET
path: "/v1/actor-runs/{run_id}/files/{idx}"
tags: ["actors"]
---

# Download a binary file from an actor's output (e.g. a captured image)

`GET /v1/actor-runs/{run_id}/files/{idx}`

## Request

- Base URL: `https://barchin.net/api`
- URL: `https://barchin.net/api/v1/actor-runs/{run_id}/files/{idx}`
- Auth: HTTP bearer

Stream one blob a binary actor produced (the image-fetch actor's output).

A dataset row's ``download_url`` points here. Requires the same bearer token as the
rest of the API and only serves the caller's own runs — an unknown or other-user run
is a 404, so run ids cannot be probed. Files expire 24h after the run finishes; a
missing or expired file is ``file_not_found``.

## Path parameters

- `run_id` string, uuid, required
- `idx` integer, required

## Response `200`

بایت‌های فایل

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `422`: Unprocessable Entity
- `429`: Too Many Requests

---

[API](https://skmtc.dev/barchin/apis/barchin-scraping-api.md) · [All operations](https://skmtc.dev/barchin/apis/barchin-scraping-api/llms.txt) · [OpenAPI document](https://skmtc.dev/barchin/apis/barchin-scraping-api/revisions/fe97e4690cc3?raw)