Get Customer Downloadable Products

Retrieve all downloadable product purchases belonging to the authenticated customer. This is a read-only API — customers can view their purchased downloadable links, check download status, and see remaining downloads.

Endpoint

GET /api/shop/customer-downloadable-products

Request Headers

Header	Value	Required	Description
Content-Type	application/json	Yes	Request content type
X-STOREFRONT-KEY	pk_storefront_xxx	Yes	Storefront API key
Authorization	Bearer {token}	Yes	Customer authentication token

Response Fields

Field	Type	Description
id	Integer	Downloadable link purchase ID
productName	String	Name of the purchased product
name	String	Name of the downloadable link
url	String	Source URL of a url-type link. Absent on a file-type purchase.
file	String	Stored path of a file-type link. Absent on a url-type purchase.
fileName	String	Display name of the file
type	String	Link type: file or url
downloadBought	Integer	Total number of allowed downloads
downloadUsed	Integer	Number of times downloaded
downloadCanceled	Integer	Number of canceled downloads
status	String	Purchase status: available, expired, or pending
remainingDownloads	Integer	downloadBought minus used and canceled. null when the purchase has no download cap.
order	String	Path of the order, e.g. /api/shop/customer-orders/384. Not a nested object.
customer	String	Path of the owning customer.
downloadUrl	String	Absolute URL of the download route. It needs both auth headers, so it is a request URL rather than a shareable link.
createdAt	DateTime	Purchase creation date
updatedAt	DateTime	Purchase last update date

Status Values

Use any of these as the ?status= filter value, or read them off the status field:

Status	Description
available	Download link is active and can be used
pending	Order has not been invoiced yet; download is not available
expired	All downloads have been used or the link has expired

Query Parameters

Parameter	Type	Default	Description
status	string	—	Filter by purchase status (available / pending / expired). ?status=available
page	integer	1	Page number.
per_page	integer	10	Items per page (max 50).

Over GraphQL: customerDownloadableProducts(status: "available", first: 10) { … }.

cURL Example

curl -X GET "https://api-demo.bagisto.com/api/shop/customer-downloadable-products" \
  -H "X-STOREFRONT-KEY: pk_storefront_your_key_here" \
  -H "Authorization: Bearer YOUR_CUSTOMER_TOKEN" \
  -H "Content-Type: application/json"

Empty Collection

When the customer has no downloadable product purchases:

[]

Notes

• Read-only API: Only GET operations are available.
• Customer isolation: Purchases are automatically filtered by the authenticated customer. A customer can never see another customer's purchases.
• Field naming: REST responses use camelCase field names (e.g., productName, downloadBought, remainingDownloads).
• Computed field: remainingDownloads is calculated as downloadBought - downloadUsed - downloadCanceled. Returns null for unlimited downloads.