Paddle Logo
Paddle Classic
Get Started
Guides
API Reference
Webhooks
Reference
Search
Login
API Reference
Overview
Quick Start
API Authentication
API Error Codes
APIs
Checkout API
Checkout API
Order Details
User History
Prices
Product API
Product API
List Products
post
Coupons
Licenses
Pay Links
Transactions
List Transactions
post
Payments
Subscription API
Subscription API
Plans
Users
Modifiers
Payments
One-off Charges
Alert API
Alert API
Webhooks

List Transactions

post
/2.0/{entity}/{id}/transactions

Retrieve transactions for related entities within Paddle

Transaction data can be retrieved using a User ID, Subscription ID, Order ID, Checkout ID (hash) or Product ID.

Example Request

preparing...

Rate limits

Paddle rate-limits calls to this endpoint to 150 calls per minute. If you exceed the limit, you receive a 429 response code, and the rate-limited IP is blocked for 60 seconds.

Usage notes

  • order_id is returned as an integer for one-time products and a string for subscription products.
  • This endpoint is paginated, with a max 300 results per page. Use the page and results_per_page parameters to work with pagination.

Request

Path Parameters

entity
string
required

Filter: Entity type of the id

Allowed values:
usersubscriptionordercheckoutproduct
id
string
required

Filter: ID number for the specified entity

Body

vendor_id
integer
required

The vendor ID identifies your seller account. This can be found in Developer Tools > Authentication.

>= 1
vendor_auth_code
string
required

The vendor auth code is a private API key for authenticating API requests. This key should never be used in client side code or shared publicly. This can be found in Developer Tools > Authentication.

Match pattern:
[0-9a-f]+
page
integer

The page of results to return. Each response page return 15 results each.

results_per_page
integer

Number of records to return per page.

>= 1<= 300
from
string<yyyy-mm-dd>

Filter: Transactions starting after the date specified

to
string<yyyy-mm-dd>

Filter: Transactions ending the day before the date specified

Parameters
:
:
Body
:
:
:
:
:
: