Analyze checkout performance with checkouts reports

What's new?

We've added a new checkouts report to the Paddle platform. It includes conversion data for each of your checkout sessions, helping you understand how your checkout is performing and which configurations convert best.

How it works

Reports in Paddle let you export information from your account to import into accounting software, ERPs, and other business intelligence tools.

To complement the existing reports in Paddle Billing, we've added a new checkouts report that gives you a row for every checkout session, with the context and performance data for each one.

Use it to see which checkouts converted and compare performance across different checkout configurations like theme, display mode, and country.

For this first release, you can filter checkouts reports by:

• checkout_created_at: the date range when checkouts were created. If you don't pass this filter, the report includes checkouts created in the previous month.
• customer_country_code: one or more customer countries, using two-letter ISO 3166-1 alpha-2 codes.

Example

This example creates a checkouts report for checkouts created in May 2026 from customers in the United States and United Kingdom:

{
  "type": "checkouts",
  "filters": [
    {
      "name": "checkout_created_at",
      "value": "2026-05-01T00:00:00Z",
      "operator": "gte"
    },
    {
      "name": "checkout_created_at",
      "value": "2026-06-01T00:00:00Z",
      "operator": "lt"
    },
    {
      "name": "customer_country_code",
      "value": ["US", "GB"]
    }
  ]
}

{
  "data": {
    "id": "rep_01hvgdhtthn1q35n79dgeqm3pv",
    "type": "checkouts",
    "rows": null,
    "status": "pending",
    "filters": [
      {
        "name": "checkout_created_at",
        "value": "2026-05-01T00:00:00Z",
        "operator": "gte"
      },
      {
        "name": "checkout_created_at",
        "value": "2026-06-01T00:00:00Z",
        "operator": "lt"
      },
      {
        "name": "customer_country_code",
        "value": ["US", "GB"],
        "operator": null
      }
    ],
    "expires_at": null,
    "created_at": "2026-06-12T08:21:36.209Z",
    "updated_at": "2026-06-12T08:21:36.209Z"
  },
  "meta": {
    "request_id": "0774e52b-fcc3-4d7e-8047-b1b1a05a3f27"
  }
}

Next steps

The checkouts report is available now in version 1 of the Paddle API and in the dashboard.

It's a non-breaking change, meaning it doesn't impact existing integrations.

Check out the checkouts report guide and the report entity overview in the API reference to get started.