List subscriptions

List subscriptions

Returns subscriptions filtered by status, customer or price, 50 per page by default and up to 200.

status takes active, canceled, past_due, paused or trialing, as a comma-separated list; customer_id and price_id narrow it further. Follow meta.pagination.next for the next page. On the MCP server, run it with execute.

Set up

Use the first option your agent supports.

MCP (official, remote)

Add this server to your agent's MCP settings, then sign in when asked.

{ "mcpServers": { "paddle": { "url": "https://mcp.paddle.com/mcp" } } }

Call the MCP tool execute.

Server URL: https://mcp.paddle.com/mcp

API (official)

• Base URL: https://api.paddle.com
• Endpoint: GET /subscriptions
• Auth: send the header Authorization: Bearer $PADDLE_API_KEY
• Get a key: https://vendors.paddle.com/authentication-v2
• Docs: https://developer.paddle.com/api-reference/about

Before doing anything else, make one read-only call to confirm access.

Rules

• Ask the user before anything that sends messages, costs money, or changes data.
• Never print API keys.