> For the complete documentation index, see [llms.txt](https://developer.paddle.com/llms.txt). # Checkouts reports Generate detailed reports about your checkouts, including conversion data for each checkout session, to analyze and improve checkout performance. --- Checkouts reports contain information about your checkouts, including conversion data for each checkout session. Use them to understand how well your checkout is performing and compare conversion across different checkout configurations. ## When to use - **Analyze checkout conversion** See which checkouts converted into completed transactions and calculate conversion rates over a period. - **Compare checkout performance** Break activity down by theme, display mode, country, and product to see which checkout configurations convert best. - **Automate reporting workflows** Generate reports via API to feed checkout performance data into your own dashboards and business intelligence tools. ## Report filters When generating checkouts reports, you can filter by: | Field | Description | Use case | |-------|-------------|------------| | `checkout_created_at` | Filter by the date range when checkouts were created. Pass an RFC 3339 datetime string with a `gte` or `lt` operator, and combine two filters to scope to a specific range. If you don't pass this filter, the report includes checkouts created in the previous month. | Reporting on checkouts for a specific period. | | `customer_country_code` | Filter by customer country. Pass one or more two-letter ISO 3166-1 alpha-2 country codes, like `US` or `GB`. | Analyzing checkout performance in specific markets. | ### How customer country is determined Paddle resolves a customer's country from the country they enter at checkout, falling back to the country derived from their IP address. Because of this, the country may differ from a customer's billing country, like when a customer uses a VPN. In rare cases when we can't capture an IP address for a customer, it may be empty. ## Report columns Each row in the report is one checkout session. Columns cover the context of the checkout and its performance: - **Context**: identifiers, timestamps, and details about the checkout and customer, like `checkout_id`, `transaction_id`, `customer_id`, `checkout_created_at`, and `customer_country_code`. - **Checkout performance**: conversion and presentation data, like `is_checkout_converted`, `transaction_currency_code`, `display_mode`, and `theme`. Column headings on checkouts reports mirror fields in [the Paddle API](https://developer.paddle.com/api-reference.md). Data is provided in the following columns: ```yaml title: Checkouts report type: object properties: checkout_id: type: string description: Unique identifier for the checkout session. title: Checkout ID public_checkout_id: type: - string - "null" description: Public identifier for the checkout session, as used in checkout URLs. `null` if the checkout has no public identifier. title: Public checkout ID transaction_id: type: - string - "null" pattern: ^txn_[a-z\d]{26}$ description: Paddle ID of the transaction created from this checkout, prefixed with `txn_`. `null` if the checkout didn't create a transaction. title: Transaction ID examples: - txn_01h04vsbhqc62t8hmd4z3b578c customer_id: type: - string - "null" pattern: ^ctm_[a-z\d]{26}$ description: Paddle ID of the customer associated with the checkout, prefixed with `ctm_`. `null` if the checkout isn't associated with a customer. title: Customer ID examples: - ctm_01grnn4zta5a1mf02jjze7y2ys checkout_created_at: type: string format: date-time description: RFC 3339 datetime string of when the checkout was created. title: Created at examples: - "2026-05-12T07:20:50.52Z" readOnly: true checkout_updated_at: type: string format: date-time description: RFC 3339 datetime string of when the checkout was last updated. title: Updated at examples: - "2026-05-12T09:14:00.00Z" readOnly: true checkout_converted_at: type: - string - "null" format: date-time description: RFC 3339 datetime string of when the checkout converted into a completed transaction. `null` if the checkout didn't convert. title: Converted at examples: - "2026-05-12T07:25:11.00Z" checkout_variant: type: - string - "null" description: Checkout experience presented to the customer, like one-page or multi-page. transaction_origin: type: - string - "null" enum: - api - web description: How the transaction created from the checkout was created. `null` if the checkout didn't create a transaction. x-enum-descriptions: api: description: Transaction created via the Paddle API. web: description: Transaction created automatically by Paddle.js for a checkout. payment_service_transaction_type: type: - string - "null" description: Transaction type reported by the payment service for the checkout. transaction_currency_code: type: - string - "null" description: Three-letter ISO 4217 currency code used for the checkout. source_domain: type: - string - "null" description: Domain that the checkout was initiated from. referrer: type: - string - "null" description: Referring URL or entity for the checkout. theme: type: - string - "null" description: Theme the checkout was displayed with, like `light` or `dark`. display_mode: type: - string - "null" description: How the checkout was displayed, like `inline` or `overlay`. last_known_customer_country_code: type: - string - "null" description: Two-letter ISO 3166-1 alpha-2 country code last known for the customer. `null` if no country is known. customer_country_name: type: - string - "null" description: Name of the customer's country. `null` if no country is known. customer_country_code: oneOf: - type: string enum: - AD - AE - AG - AI - AL - AM - AO - AR - AS - AT - AU - AW - AX - AZ - BA - BB - BD - BE - BF - BG - BH - BI - BJ - BL - BM - BN - BO - BQ - BR - BS - BT - BV - BW - BZ - CA - CC - CG - CH - CI - CK - CL - CM - CN - CO - CR - CV - CW - CX - CY - CZ - DE - DJ - DK - DM - DO - DZ - EC - EE - EG - EH - ER - ES - ET - FI - FJ - FK - FM - FO - FR - GA - GB - GD - GE - GF - GG - GH - GI - GL - GM - GN - GP - GQ - GR - GS - GT - GU - GW - GY - HK - HM - HN - HR - HU - ID - IE - IL - IM - IN - IO - IQ - IS - IT - JE - JM - JO - JP - KE - KG - KH - KI - KM - KN - KR - KW - KY - KZ - LA - LB - LC - LI - LK - LR - LS - LT - LU - LV - MA - MC - MD - ME - MF - MG - MH - MK - MN - MO - MP - MQ - MR - MS - MT - MU - MV - MW - MX - MY - MZ - NA - NC - NE - NF - NG - NL - "NO" - NP - NR - NU - NZ - OM - PA - PE - PF - PG - PH - PK - PL - PM - PN - PR - PS - PT - PW - PY - QA - RE - RO - RS - RW - SA - SB - SC - SE - SG - SH - SI - SJ - SK - SL - SM - SN - SR - ST - SV - SX - SZ - TC - TD - TF - TG - TH - TJ - TK - TL - TM - TN - TO - TR - TT - TV - TW - TZ - UA - UG - UM - US - UY - UZ - VA - VC - VG - VI - VN - VU - WF - WS - XK - YT - ZA - ZM description: Two-letter ISO 3166-1 alpha-2 representation of a supported country. x-enum-descriptions: AD: description: Andorra AE: description: United Arab Emirates AG: description: Antigua and Barbuda AI: description: Anguilla AL: description: Albania AM: description: Armenia AO: description: Angola AR: description: Argentina AS: description: American Samoa AT: description: Austria AU: description: Australia AW: description: Aruba AX: description: Åland Islands AZ: description: Azerbaijan BA: description: Bosnia and Herzegovina BB: description: Barbados BD: description: Bangladesh BE: description: Belgium BF: description: Burkina Faso BG: description: Bulgaria BH: description: Bahrain BI: description: Burundi BJ: description: Benin BL: description: Saint Barthélemy BM: description: Bermuda BN: description: Brunei BO: description: Bolivia BQ: description: Caribbean Netherlands (Bonaire, Sint Eustatius, and Saba) BR: description: Brazil BS: description: Bahamas BT: description: Bhutan BV: description: Bouvet Island BW: description: Botswana BZ: description: Belize CA: description: Canada CC: description: Cocos Islands CG: description: Republic of Congo CH: description: Switzerland CI: description: Côte d'Ivoire (Ivory Coast) CK: description: Cook Islands CL: description: Chile CM: description: Cameroon CN: description: China CO: description: Colombia CR: description: Costa Rica CV: description: Cape Verde CW: description: Curaçao CX: description: Christmas Island CY: description: Cyprus CZ: description: Czechia (Czech Republic) DE: description: Germany DJ: description: Djibouti DK: description: Denmark DM: description: Dominica DO: description: Dominican Republic DZ: description: Algeria EC: description: Ecuador EE: description: Estonia EG: description: Egypt EH: description: Western Sahara ER: description: Eritrea ES: description: Spain ET: description: Ethiopia FI: description: Finland FJ: description: Fiji FK: description: Falkland Islands FM: description: Micronesia FO: description: Faroe Islands FR: description: France GA: description: Gabon GB: description: United Kingdom GD: description: Grenada GE: description: Georgia GF: description: French Guiana GG: description: Guernsey GH: description: Ghana GI: description: Gibraltar GL: description: Greenland GM: description: Gambia GN: description: Guinea GP: description: Guadeloupe GQ: description: Equatorial Guinea GR: description: Greece GS: description: South Georgia and the South Sandwich Islands GT: description: Guatemala GU: description: Guam GW: description: Guinea-Bissau GY: description: Guyana HK: description: Hong Kong HM: description: Heard Island and McDonald Islands HN: description: Honduras HR: description: Croatia HU: description: Hungary ID: description: Indonesia IE: description: Ireland IL: description: Israel IM: description: Isle of Man IN: description: India IO: description: British Indian Ocean Territory IQ: description: Iraq IS: description: Iceland IT: description: Italy JE: description: Jersey JM: description: Jamaica JO: description: Jordan JP: description: Japan KE: description: Kenya KG: description: Kyrgyzstan KH: description: Cambodia KI: description: Kiribati KM: description: Comoros KN: description: Saint Kitts and Nevis KR: description: South Korea KW: description: Kuwait KY: description: Cayman Islands KZ: description: Kazakhstan LA: description: Lao People's Democratic Republic (Laos) LB: description: Lebanon LC: description: Saint Lucia LI: description: Liechtenstein LK: description: Sri Lanka LR: description: Liberia LS: description: Lesotho LT: description: Lithuania LU: description: Luxembourg LV: description: Latvia MA: description: Morocco MC: description: Monaco MD: description: Moldova ME: description: Montenegro MF: description: Saint Martin MG: description: Madagascar MH: description: Marshall Islands MK: description: Macedonia MN: description: Mongolia MO: description: Macao MP: description: Northern Mariana Islands MQ: description: Martinique MR: description: Mauritania MS: description: Montserrat MT: description: Malta MU: description: Mauritius MV: description: Maldives MW: description: Malawi MX: description: Mexico MY: description: Malaysia MZ: description: Mozambique NA: description: Namibia NC: description: New Caledonia NE: description: Niger NF: description: Norfolk Island NG: description: Nigeria NL: description: Netherlands "NO": description: Norway NP: description: Nepal NR: description: Nauru NU: description: Niue NZ: description: New Zealand OM: description: Oman PA: description: Panama PE: description: Peru PF: description: French Polynesia PG: description: Papua New Guinea PH: description: Philippines PK: description: Pakistan PL: description: Poland PM: description: Saint Pierre and Miquelon PN: description: Pitcairn PR: description: Puerto Rico PS: description: Palestinian territories PT: description: Portugal PW: description: Palau PY: description: Paraguay QA: description: Qatar RE: description: Reunion RO: description: Romania RS: description: Republic of Serbia RW: description: Rwanda SA: description: Saudi Arabia SB: description: Solomon Islands SC: description: Seychelles SE: description: Sweden SG: description: Singapore SH: description: Saint Helena SI: description: Slovenia SJ: description: Svalbard and Jan Mayen SK: description: Slovakia SL: description: Sierra Leone SM: description: San Marino SN: description: Senegal SR: description: Suriname ST: description: São Tomé and Príncipe SV: description: El Salvador SX: description: Sint Maarten SZ: description: Swaziland TC: description: Turks and Caicos Islands TD: description: Chad TF: description: French Southern and Antarctic Lands TG: description: Togo TH: description: Thailand TJ: description: Tajikistan TK: description: Tokelau TL: description: Timor-Leste TM: description: Turkmenistan TN: description: Tunisia TO: description: Tonga TR: description: Turkey TT: description: Trinidad and Tobago TV: description: Tuvalu TW: description: Taiwan TZ: description: Tanzania UA: description: Ukraine UG: description: Uganda UM: description: United States Minor Outlying Islands US: description: United States UY: description: Uruguay UZ: description: Uzbekistan VA: description: Holy See (Vatican City) VC: description: Saint Vincent and the Grenadines VG: description: British Virgin Islands VI: description: U.S. Virgin Islands VN: description: Vietnam VU: description: Vanuatu WF: description: Wallis and Futuna WS: description: Samoa XK: description: Kosovo YT: description: Mayotte ZA: description: South Africa ZM: description: Zambia description: Two-letter ISO 3166-1 alpha-2 country code for the customer. Resolved from the customer's entered country, falling back to their IP-derived country. Empty if no country is known. customer_zip_code: type: - string - "null" description: Zip or postal code of the customer. customer_ip_country_code: type: - string - "null" description: Two-letter ISO 3166-1 alpha-2 country code derived from the customer's IP address. May differ from the customer's billing country, for example when using a VPN. customer_country_state: type: - string - "null" description: Two-letter abbreviation of the state where the checkout took place. Only for customers in the USA. customer_tax_code: type: - string - "null" description: Tax identifier provided by the customer. product_id_list: type: array items: type: string description: Array of product IDs included in the checkout. product_name_list: type: array items: type: string description: Array of product names included in the checkout. is_checkout_converted: type: boolean description: Whether the checkout led to a completed transaction. is_checkout_recovered: type: boolean description: Whether the checkout was recovered after initially being abandoned. is_checkout_recoverable: type: boolean description: Whether the checkout is eligible for recovery. is_initiated_from_customer_portal: type: boolean description: Whether the checkout was started from the customer portal. is_saved_payment_method_attempted: type: boolean description: Whether a saved payment method was attempted during the checkout. has_customer_email: type: boolean description: Whether a customer email address was captured during the checkout. transaction_amount_in_transaction_currency: type: - string - "null" description: Total amount of the transaction created from the checkout, in the transaction currency. `null` if the checkout didn't create a transaction. ```