list_prices

list_prices

Retrieve and filter prices from your Paddle catalog by product ID, status, or type. Supports pagination, sorting, and including related entities like products. Amounts are in the smallest currency unit (e.g., cents).

Instructions

This tool will list prices in your Paddle catalog.

Use the maximum perPage by default (200) to ensure comprehensive results. Filter prices by product ID, status, recurring, 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 products if needed. Amounts are in the smallest currency unit (e.g., cents).

Input Schema

Name	Required	Description
`after`	No	Cursor for pagination. Returns results after the cursor position.
`id`	No	Filter by a list of price IDs. Use this to retrieve multiple prices by ID.
`include`	No	Related entities to include in the response.
`orderBy`	No	Sort field and order.
`perPage`	No	Number of records to return per page. Default is 25, maximum is 50.
`productId`	No	Filter by a list of product IDs. Returns prices for the specified products.
`status`	No	Filter by price status. Returns prices with the specified statuses.

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "after": {
      "description": "Cursor for pagination. Returns results after the cursor position.",
      "type": "string"
    },
    "id": {
      "description": "Filter by a list of price IDs. Use this to retrieve multiple prices by ID.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "include": {
      "description": "Related entities to include in the response.",
      "items": {
        "enum": [
          "product"
        ],
        "type": "string"
      },
      "type": "array"
    },
    "orderBy": {
      "description": "Sort field and order.",
      "enum": [
        "billing_cycle.frequency[ASC]",
        "billing_cycle.frequency[DESC]",
        "billing_cycle.interval[ASC]",
        "billing_cycle.interval[DESC]",
        "id[ASC]",
        "id[DESC]",
        "product_id[ASC]",
        "product_id[DESC]",
        "quantity.maximum[ASC]",
        "quantity.maximum[DESC]",
        "quantity.minimum[ASC]",
        "quantity.minimum[DESC]",
        "status[ASC]",
        "status[DESC]",
        "tax_mode[ASC]",
        "tax_mode[DESC]",
        "unit_price.amount[ASC]",
        "unit_price.amount[DESC]",
        "unit_price.currency_code[ASC]",
        "unit_price.currency_code[DESC]"
      ],
      "type": "string"
    },
    "perPage": {
      "description": "Number of records to return per page. Default is 25, maximum is 50.",
      "type": "number"
    },
    "productId": {
      "description": "Filter by a list of product IDs. Returns prices for the specified products.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "status": {
      "description": "Filter by price status. Returns prices with the specified statuses.",
      "items": {
        "enum": [
          "active",
          "archived"
        ],
        "type": "string"
      },
      "type": "array"
    }
  },
  "type": "object"
}

Paddle MCP Server

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Paddle MCP Server

Related Tools