list_transactions

Retrieve and filter transactions from your Paddle account by date, status, customer ID, or other criteria. Include related data like addresses, adjustments, or discounts. Results are paginated and sortable for efficient analysis.

Instructions

This tool will list transactions from your Paddle account.

Use the maximum perPage by default (30) to ensure comprehensive results. Filter transactions by billing and creation dates, collection mode, customer ID, invoice number, origin, status and subscription ID as required. You can include related information such as addresses, adjustments, adjustment totals, available payment methods, business details, customer data, and discounts when 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. Amounts are in the smallest currency unit (e.g., cents).

Input Schema

Name	Required	Description
`after`	No	Return entities after the specified Paddle ID when working with paginated endpoints.
`billedAt`	No	Return entities billed at a specific time. Pass an RFC 3339 datetime string.
`billedAt_gt`	No	Return entities billed after a specific time. Pass an RFC 3339 datetime string.
`billedAt_gte`	No	Return entities billed at or after a specific time. Pass an RFC 3339 datetime string.
`billedAt_lt`	No	Return entities billed before a specific time. Pass an RFC 3339 datetime string.
`billedAt_lte`	No	Return entities billed at or before a specific time. Pass an RFC 3339 datetime string.
`collectionMode`	No	Return entities that match the specified collection mode.
`createdAt`	No	Return entities created at a specific time. Pass an RFC 3339 datetime string.
`createdAt_gt`	No	Return entities created after a specific time. Pass an RFC 3339 datetime string.
`createdAt_gte`	No	Return entities created at or after a specific time. Pass an RFC 3339 datetime string.
`createdAt_lt`	No	Return entities created before a specific time. Pass an RFC 3339 datetime string.
`createdAt_lte`	No	Return entities created at or before a specific time. Pass an RFC 3339 datetime string.
`customerId`	No	Return entities related to the specified customer.
`id`	No	Return only the IDs specified.
`include`	No	Include related entities in the response.
`invoiceNumber`	No	Return entities that match the invoice number.
`orderBy`	No	Order returned entities by field and direction.
`origin`	No	Return entities related to the specified origin.
`perPage`	No	Set how many entities are returned per page.
`status`	No	Return entities that match the specified status.
`subscriptionId`	No	Return entities related to the specified subscription. Pass null to return entities not related to any subscription.
`updatedAt`	No	Return entities updated at a specific time. Pass an RFC 3339 datetime string.
`updatedAt_gt`	No	Return entities updated after a specific time. Pass an RFC 3339 datetime string.
`updatedAt_gte`	No	Return entities updated at or after a specific time. Pass an RFC 3339 datetime string.
`updatedAt_lt`	No	Return entities updated before a specific time. Pass an RFC 3339 datetime string.
`updatedAt_lte`	No	Return entities updated at or before a specific time. Pass an RFC 3339 datetime string.

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "after": {
      "description": "Return entities after the specified Paddle ID when working with paginated endpoints.",
      "type": "string"
    },
    "billedAt": {
      "description": "Return entities billed at a specific time. Pass an RFC 3339 datetime string.",
      "type": "string"
    },
    "billedAt_gt": {
      "description": "Return entities billed after a specific time. Pass an RFC 3339 datetime string.",
      "type": "string"
    },
    "billedAt_gte": {
      "description": "Return entities billed at or after a specific time. Pass an RFC 3339 datetime string.",
      "type": "string"
    },
    "billedAt_lt": {
      "description": "Return entities billed before a specific time. Pass an RFC 3339 datetime string.",
      "type": "string"
    },
    "billedAt_lte": {
      "description": "Return entities billed at or before a specific time. Pass an RFC 3339 datetime string.",
      "type": "string"
    },
    "collectionMode": {
      "description": "Return entities that match the specified collection mode.",
      "enum": [
        "automatic",
        "manual"
      ],
      "type": "string"
    },
    "createdAt": {
      "description": "Return entities created at a specific time. Pass an RFC 3339 datetime string.",
      "type": "string"
    },
    "createdAt_gt": {
      "description": "Return entities created after a specific time. Pass an RFC 3339 datetime string.",
      "type": "string"
    },
    "createdAt_gte": {
      "description": "Return entities created at or after a specific time. Pass an RFC 3339 datetime string.",
      "type": "string"
    },
    "createdAt_lt": {
      "description": "Return entities created before a specific time. Pass an RFC 3339 datetime string.",
      "type": "string"
    },
    "createdAt_lte": {
      "description": "Return entities created at or before a specific time. Pass an RFC 3339 datetime string.",
      "type": "string"
    },
    "customerId": {
      "description": "Return entities related to the specified customer.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "id": {
      "description": "Return only the IDs specified.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "include": {
      "description": "Include related entities in the response.",
      "items": {
        "enum": [
          "address",
          "adjustment",
          "adjustments_totals",
          "business",
          "customer",
          "discount"
        ],
        "type": "string"
      },
      "type": "array"
    },
    "invoiceNumber": {
      "description": "Return entities that match the invoice number.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "orderBy": {
      "description": "Order returned entities by field and direction.",
      "enum": [
        "billed_at[ASC]",
        "billed_at[DESC]",
        "created_at[ASC]",
        "created_at[DESC]",
        "id[ASC]",
        "id[DESC]",
        "updated_at[ASC]",
        "updated_at[DESC]"
      ],
      "type": "string"
    },
    "origin": {
      "description": "Return entities related to the specified origin.",
      "items": {
        "enum": [
          "api",
          "subscription_charge",
          "subscription_payment_method_change",
          "subscription_recurring",
          "subscription_update",
          "web"
        ],
        "type": "string"
      },
      "type": "array"
    },
    "perPage": {
      "description": "Set how many entities are returned per page.",
      "type": "number"
    },
    "status": {
      "description": "Return entities that match the specified status.",
      "items": {
        "enum": [
          "draft",
          "ready",
          "billed",
          "paid",
          "completed",
          "canceled",
          "past_due"
        ],
        "type": "string"
      },
      "type": "array"
    },
    "subscriptionId": {
      "description": "Return entities related to the specified subscription. Pass null to return entities not related to any subscription.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "updatedAt": {
      "description": "Return entities updated at a specific time. Pass an RFC 3339 datetime string.",
      "type": "string"
    },
    "updatedAt_gt": {
      "description": "Return entities updated after a specific time. Pass an RFC 3339 datetime string.",
      "type": "string"
    },
    "updatedAt_gte": {
      "description": "Return entities updated at or after a specific time. Pass an RFC 3339 datetime string.",
      "type": "string"
    },
    "updatedAt_lt": {
      "description": "Return entities updated before a specific time. Pass an RFC 3339 datetime string.",
      "type": "string"
    },
    "updatedAt_lte": {
      "description": "Return entities updated at or before a specific time. Pass an RFC 3339 datetime string.",
      "type": "string"
    }
  },
  "type": "object"
}

Paddle MCP Server