---
title: "Download Purchased Image"
method: GET
path: "/v1/marketplace/purchases/{purchase_id}/download"
tags: ["Marketplace"]
---

# Download Purchased Image

`GET /v1/marketplace/purchases/{purchase_id}/download`

## Request

- Base URL: `https://api.lumethic.com`
- URL: `https://api.lumethic.com/v1/marketplace/purchases/{purchase_id}/download`
- Auth: `OAuth2PasswordBearer` (a scheme the document does not define)

Download the original high-resolution image for a completed purchase.

Stream the full-resolution JPEG for a purchase you own. The purchase must have status
`completed` (payment confirmed) and the download link must not be expired.

**Authentication Required**: Valid API key or JWT token (purchase buyer only)

**Path Parameters**:
- **purchase_id**: UUID of the purchase

**Response**: Streams the JPEG image with `Content-Disposition: attachment` headers.

**Status Codes**:
- 200: Image streamed successfully
- 402: Purchase not yet completed (payment pending)
- 403: Access denied (not the buyer)
- 404: Purchase not found or image data unavailable
- 410: Download link has expired

## Path parameters

- `purchase_id` string, uuid, required

## Headers

- `X-API-Key` string, nullable

## Response `200`

Image streamed as JPEG

- unknown

## Other responses

- `402`: Payment pending
- `403`: Access denied
- `404`: Not found
- `410`: Download expired
- `422`: Validation Error

---

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