---
title: "Get Buyer Purchases"
method: GET
path: "/v1/marketplace/purchases"
tags: ["Marketplace"]
---

# Get Buyer Purchases

`GET /v1/marketplace/purchases`

## Request

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

List all photo licenses you have purchased.

Retrieve your purchase history including payment status, license type, and download
availability. Only completed purchases allow image downloads.

**Authentication Required**: Valid API key or JWT token

**Query Parameters**:
- **limit**: Max results to return (default 50)
- **offset**: Number of results to skip for pagination (default 0)

**Status Codes**:
- 200: Purchases returned (empty array if none)

## Query parameters

- `limit` integer: Maximum number of results to return
- `offset` integer: Number of results to skip for pagination

## Headers

- `X-API-Key` string, nullable

## Response `200`

Purchases returned

- PurchaseResponse[]
  - `id` string, uuid, required: Unique identifier for the purchase
  - `listing_id` string, uuid, required: ID of the listing this purchase is for
  - `currency` string, required: ISO 4217 currency code used for the purchase
  - `price_cents` integer, required: Amount paid in cents
  - `license_type` string, required: Type of license purchased: personal, commercial, editorial, or extended
  - `status` string, required: Payment status: pending, completed, or failed
  - `download_expires_at` string, nullable, required: ISO 8601 timestamp when download access expires
  - `created_at` string, required: ISO 8601 timestamp when the purchase was initiated

## Other responses

- `404`: Not found
- `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)