list_products

list_products

Retrieve and manage products from your Paddle catalog with pagination, filtering by status, tax category, and type, and sorting options. Includes related entities like prices for detailed insights.

Instructions

This tool will list products in your Paddle catalog.

Use the maximum perPage by default (200) to ensure comprehensive results. Filter products by status, tax category, and type as needed. Results are paginated - use the 'after' parameter with the last ID from previous results to get the next page. Sort results using orderBy parameter. Include related entities like prices if needed. Amounts are in the smallest currency unit (e.g., cents).

Input Schema

Name	Required	Description
`after`	No	Cursor for use in pagination. Represents the ID of the last entity in the previous page of results.
`id`	No	Filter products by their ID. Accepts multiple values.
`include`	No	Related data to include in the response.
`orderBy`	No	Sort order for returned items.
`perPage`	No	Number of items to be returned per page (default: 25, maximum: 50).
`status`	No	Filter products by their status. Accepts multiple values.
`taxCategory`	No	Filter products by their tax category. Accepts multiple values.
`type`	No	Filter products by their type. Accepts multiple values.

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "after": {
      "description": "Cursor for use in pagination. Represents the ID of the last entity in the previous page of results.",
      "type": "string"
    },
    "id": {
      "description": "Filter products by their ID. Accepts multiple values.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "include": {
      "description": "Related data to include in the response.",
      "items": {
        "enum": [
          "prices"
        ],
        "type": "string"
      },
      "type": "array"
    },
    "orderBy": {
      "description": "Sort order for returned items.",
      "enum": [
        "created_at[ASC]",
        "created_at[DESC]",
        "custom_data[ASC]",
        "custom_data[DESC]",
        "description[ASC]",
        "description[DESC]",
        "id[ASC]",
        "id[DESC]",
        "image_url[ASC]",
        "image_url[DESC]",
        "name[ASC]",
        "name[DESC]",
        "status[ASC]",
        "status[DESC]",
        "tax_category[ASC]",
        "tax_category[DESC]",
        "updated_at[ASC]",
        "updated_at[DESC]"
      ],
      "type": "string"
    },
    "perPage": {
      "description": "Number of items to be returned per page (default: 25, maximum: 50).",
      "type": "number"
    },
    "status": {
      "description": "Filter products by their status. Accepts multiple values.",
      "items": {
        "enum": [
          "active",
          "archived"
        ],
        "type": "string"
      },
      "type": "array"
    },
    "taxCategory": {
      "description": "Filter products by their tax category. Accepts multiple values.",
      "items": {
        "enum": [
          "digital-goods",
          "ebooks",
          "implementation-services",
          "professional-services",
          "saas",
          "software-programming-services",
          "standard",
          "training-services",
          "website-hosting"
        ],
        "type": "string"
      },
      "type": "array"
    },
    "type": {
      "description": "Filter products by their type. Accepts multiple values.",
      "items": {
        "enum": [
          "standard",
          "custom"
        ],
        "type": "string"
      },
      "type": "array"
    }
  },
  "type": "object"
}

Paddle MCP Server

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Paddle MCP Server

Related Tools