> For the complete documentation index, see [llms.txt](https://developer.paddle.com/llms.txt).

# Analyze checkout performance with checkouts reports

Generate a new checkouts report to see conversion data for each of your checkout sessions, so you can understand how your checkout is performing and improve it.

---

## 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](https://developer.paddle.com/build/reports.md) 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](https://developer.paddle.com/build/reports/checkouts.md) 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:

{% api-example method="POST" path="/reports" href="/api-reference/reports/create-report" %}

```json
{
  "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"]
    }
  ]
}
```

```json
{
  "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"
  }
}
```

{% /api-example %}

## 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](https://developer.paddle.com/build/reports/checkouts.md) and the [report entity overview](https://developer.paddle.com/api-reference/reports.md) in the API reference to get started.
## Summary of changes

| Name | Type | Change | Entity | Description |
| --- | --- | --- | --- | --- |
| `type` | Enum value | added | Report | checkouts added. |
| `checkout_created_at` | Field | added | Reports | Filter checkouts reports by the date a checkout was created. |
| `customer_country_code` | Field | added | Reports | Filter checkouts reports by customer country, using two-letter ISO 3166-1 alpha-2 codes. |