List Products

Endpoint

GET https://api.gumroad.com/v2/products

Retrieve all products owned by the authenticated user. Products are returned in descending order by creation date.

Authentication

Requires OAuth scope: view_public or any public scope

Response

boolean

required

Whether the request was successful

array

required

Array of product objects

Show Product object

string

required

The product’s unique external ID

string

required

The product name

string

The product description in HTML format

string

The custom URL path (if set)

integer

required

The price in cents

string

required

The currency code (e.g., “usd”)

string

required

The product’s full URL

string

URL to the product thumbnail image

array

Array of tag names associated with the product

string

required

Human-readable formatted price

boolean

required

Whether the product is published and available for purchase

boolean

required

Whether the product has been deleted

boolean

Whether the product has a “pay what you want” price

string

For recurring products: “monthly”, “yearly”, “quarterly”, “biannually”, or “every_two_years”

boolean

Whether the product requires shipping information

string

URL to preview the product

string

Custom receipt message

string

Custom product summary

integer

Maximum number of purchases allowed (null if unlimited)

object

Information about attached files (only if single file)

array

Custom fields to collect at checkout

boolean

Whether this is a tiered membership product

array

Available billing recurrences for tiered memberships

array

Product variants with pricing and options

Show Variant object

string

Variant category title

array

Array of variant options

Show Option object

string

Option name

integer

Price difference in cents from base price

boolean

Whether this variant has customizable pricing

object

Recurrence prices for tiered memberships

integer

Number of successful sales (requires view_sales scope)

integer

Total sales in USD cents (requires view_sales scope)

Example Request

curl -X GET "https://api.gumroad.com/v2/products" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

const response = await fetch('https://api.gumroad.com/v2/products', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN'
  }
});

const data = await response.json();

import requests

response = requests.get(
    'https://api.gumroad.com/v2/products',
    headers={'Authorization': 'Bearer YOUR_ACCESS_TOKEN'}
)

data = response.json()

Example Response

{
  "success": true,
  "products": [
    {
      "id": "kUxDaJMg5NP9PpHRCNYCrw==",
      "name": "My Awesome Product",
      "description": "<p>This is an amazing product</p>",
      "custom_permalink": "awesome-product",
      "price": 2999,
      "currency": "usd",
      "short_url": "https://example.gumroad.com/l/awesome-product",
      "thumbnail_url": "https://public-files.gumroad.com/...",
      "tags": ["digital", "course"],
      "formatted_price": "$29.99",
      "published": true,
      "deleted": false,
      "customizable_price": false,
      "require_shipping": false,
      "preview_url": null,
      "custom_receipt": null,
      "custom_summary": null,
      "subscription_duration": null,
      "max_purchase_count": null,
      "file_info": {},
      "custom_fields": [],
      "is_tiered_membership": false,
      "recurrences": null,
      "variants": [],
      "sales_count": 42,
      "sales_usd_cents": 125958
    }
  ]
}

Error Responses

boolean

false when the request fails

string

Error description

Example Error

{
  "success": false,
  "message": "Unauthorized"
}

The sales_count and sales_usd_cents fields are only included in the response when the access token has the view_sales scope.

Getting Started

Products

Sales

Licenses

Subscribers

Other Resources

Endpoint

Authentication

Response

Example Request

Example Response

Error Responses

Example Error

​Endpoint

​Authentication

​Response

​Example Request

​Example Response

​Error Responses

​Example Error

Endpoint

Authentication

Response

Example Request

Example Response

Error Responses

Example Error