List Digital Products

Overview

A digital product represents the link between a Shopify product (or variant) and one or more assets in Filemonk. When a customer purchases the Shopify product, they receive access to the linked assets for download.

Query parameters

• shopify_product_id (integer, query)

  Filter by Shopify product ID (numeric). Returns all digital products linked to this product, including any variant-level links.

• page (integer, query, default 1)

  Page number for pagination.

• per_page (integer, query, default 25)

  Number of digital products per page. Minimum: 1, maximum: 100.

Response

• digital_products (array, required)

  List of digital product objects.

  Digital product properties:

  • id (string, required)

    Unique digital product identifier (UUID).

  • shopify_product_id (integer | null)

    The numeric Shopify product ID.

  • shopify_variant_id (integer | null)

    The numeric Shopify variant ID. null if linked at the product level (applies to all variants).

  • assets (array, required)

    The assets attached to this digital product.

  • upsert_always (boolean, required)

    When true, a new copy of this digital product’s assets is created for each order.

  • custom_message (string | null)

    Custom message shown to customers on the download page.

  • preorder_enabled (boolean, required)

    Whether this is a preorder product.

  • preorder_launch_date (string | null)

    ISO 8601 timestamp of when preorder content becomes available.

  • preorder_subject (string | null)

    Email subject for the preorder notification.

  • preorder_heading (string | null)

    Heading shown on the download page while in preorder.

  • preorder_description (string | null)

    Description shown on the download page while in preorder.

  • created_at (string, required)

    ISO 8601 timestamp of when the digital product was created.

  • updated_at (string, required)

    ISO 8601 timestamp of when the digital product was last updated.

• pagination (object, required)

  Pagination metadata.

  Pagination properties:

  • current_page (integer, required)

    Current page number.

  • per_page (integer, required)

    Number of items per page.

  • total_count (integer, required)

    Total number of digital products matching the filters.

  • total_pages (integer, required)

    Total number of pages.

Example request

curl -X GET 'https://app.filemonk.io/api/v1/external/digital_products?per_page=10' \
  -H 'X-Auth-Token: fm_api_key_your_key_here'

const response = await fetch(
  'https://app.filemonk.io/api/v1/external/digital_products?per_page=10',
  { headers: { 'X-Auth-Token': 'fm_api_key_your_key_here' } }
);
const data = await response.json();

response = requests.get(
    'https://app.filemonk.io/api/v1/external/digital_products',
    headers={'X-Auth-Token': 'fm_api_key_your_key_here'},
    params={'per_page': 10}
)
data = response.json()

Example response

{
  "digital_products": [
    {
      "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "shopify_product_id": 8847261098265,
      "shopify_variant_id": null,
      "assets": [
        {
          "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
          "type": "external",
          "name": "Photoshop Brushes Pack",
          "filename": "brushes-pack-v2.zip",
          "external_url": "https://cdn.example.com/files/brushes-pack-v2.zip",
          "content_type": "application/zip",
          "byte_size": 0,
          "created_at": "2026-03-01T14:30:00Z"
        }
      ],
      "upsert_always": false,
      "custom_message": "Thanks for your purchase!",
      "preorder_enabled": false,
      "preorder_launch_date": null,
      "preorder_subject": null,
      "preorder_heading": null,
      "preorder_description": null,
      "created_at": "2026-03-05T10:00:00Z",
      "updated_at": "2026-03-05T10:00:00Z"
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 10,
    "total_count": 5,
    "total_pages": 1
  }
}

{
  "error": "Invalid API key"
}