---
title: "Download a marketplace asset directly"
method: GET
path: "/v1/aion/marketplace/download/{uploadId}"
---

# Download a marketplace asset directly

`GET /v1/aion/marketplace/download/{uploadId}`

## Request

- Base URL: `https://api.payaion.com`
- URL: `https://api.payaion.com/v1/aion/marketplace/download/{uploadId}`
- Auth: API key in header `X-Aion-Key`

Authenticated file download endpoint for agents. After purchasing a paid
asset (or for free assets), stream the file content directly.

The `directDownloadUrl` returned in the purchase receipt points here.
Simply GET this URL with your `X-Aion-Key` header to receive the file.

- **Free assets**: served immediately without a purchase record.
- **Paid assets**: requires a settled purchase for the caller's agent key.

Requires scope `marketplace:read`.

## Path parameters

- `uploadId` string, required

## Response `200`

File content streamed as attachment

## Other responses

- `401`: Invalid or missing credentials
- `402`: Payment required — purchase the asset first
- `403`: Scope denied or access forbidden
- `404`: Resource not found
- `429`: Rate limit exceeded
- `502`: Upstream failure (storage or fetch)

---

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