Public preview
Revenue Recognition API Public preview
Access Stripe Revenue Recognition reports programmatically to automate your accrual accounting.
For accrual accounting, Stripe Revenue Recognition provides downloadable reports, such as a period summary and a revenue waterfall. You can download these reports in CSV format through the Dashboard or you can programmatically access them through the API.
Stripe Revenue Recognition has six supported report types:
- revenue _ recognition. debit _ credit _ summary. 1
- revenue _ recognition. debit _ credit _ by _ price. 1
- revenue _ recognition. debit _ credit _ by _ product. 1
- revenue _ recognition. debit _ credit _ by _ customer. 1
- revenue _ recognition. debit _ credit _ by _ invoice. 1
- revenue _ recognition. debit _ credit _ by _ invoice _ line _ item. 1
Caution
Because this feature is in beta, the data fields might change.
Download a report
The following example downloads the debits and credits by summary for May 2025.
First, create a report run using Create a Report Run.
To get a report for May 2025, set parameters[interval_start] to 1 May 2025 and parameters[interval_end] to 1 Jun 2025.
Command Line
Select a language
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
Next, check whether the Report Run object succeeds by fetching the report run object:
The report run object ID starts with frr_.
Command Line
Select a language
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
When the object’s status is succeeded, you can download the CSV using its result.id value, as in the following example:
The report run result ID starts with file_.
Command Line
curl
Report Run Parameters
| Report Type | Required Run Parameters | Optional Run Parameters |
|---|---|---|
| revenue_recognition.debit_credit_summary.1 | interval_start interval_end | decimal_format |
| revenue_recognition.debit_credit_by_price.1 | interval_start interval_end | customer decimal_format |
| revenue_recognition.debit_credit_by_product.1 | interval_start interval_end | customer decimal_format |
| revenue_recognition.debit_credit_by_customer.1 | interval_start interval_end | decimal_format |
| revenue_recognition.debit_credit_by_invoice.1 | interval_start interval_end | customer invoice invoice_line_item decimal_format |
| revenue_recognition.debit_credit_by_invoice_line_item.1 | interval_start interval_end | customer invoice invoice_line_item decimal_format |
Report Run Columns
By default, reports are run with the default set of columns. You can customize the selection and ordering of columns in the output by including the optional columns parameter with a list of column names. You can find the supported columns for each report type below.
Summary
API report type: revenue_recognition.debit_credit_summary.1
| Column Name | Default | Description |
|---|---|---|
| accounting_period | The accounting period | |
| open_accounting_period | The open accounting period; entries in open periods are subject to change | |
| currency | Three-letter ISO code for the currency of the amount. | |
| debit | The debited account | |
| credit | The credited account | |
| amount | Amount change, expressed in major units of the currency (for example, dollars for USD, or pesos for MXN). | |
| credit_gl_code | The credited general ledger code | |
| debit_gl_code | The debited general ledger code |
By Price
API report type: revenue_recognition.debit_credit_by_price.1
| Column Name | Default | Description |
|---|---|---|
| accounting_period | The accounting period | |
| open_accounting_period | The open accounting period; entries in open periods are subject to change | |
| currency | Three-letter ISO code for the currency of the amount. | |
| price_id | The price associated with this change. | |
| debit | The debited account | |
| credit | The credited account | |
| amount | Amount change, expressed in major units of the currency (for example, dollars for USD, or pesos for MXN). | |
| credit_gl_code | The credited general ledger code | |
| debit_gl_code | The debited general ledger code |
By Product
API report type: revenue_recognition.debit_credit_by_product.1
| Column Name | Default | Description |
|---|---|---|
| accounting_period | The accounting period | |
| open_accounting_period | The open accounting period; entries in open periods are subject to change | |
| currency | Three-letter ISO code for the currency of the amount. | |
| product_id | The product associated with this change. | |
| debit | The debited account | |
| credit | The credited account | |
| amount | Amount change, expressed in major units of the currency (for example, dollars for USD, or pesos for MXN). | |
| credit_gl_code | The credited general ledger code | |
| debit_gl_code | The debited general ledger code |
By Customer
API report type: revenue_recognition.debit_credit_by_customer.1
| Column Name | Default | Description |
|---|---|---|
| accounting_period | The accounting period | |
| open_accounting_period | The open accounting period; entries in open periods are subject to change | |
| currency | Three-letter ISO code for the currency of the amount. | |
| customer_id | The customer associated with this change. | |
| debit | The debited account | |
| credit | The credited account | |
| amount | Amount change, expressed in major units of the currency (for example, dollars for USD, or pesos for MXN). | |
| credit_gl_code | The credited general ledger code | |
| debit_gl_code | The debited general ledger code |
By Invoice
API report type: revenue_recognition.debit_credit_by_invoice.1
| Column Name | Default | Description |
|---|---|---|
| accounting_period | The accounting period | |
| open_accounting_period | The open accounting period; entries in open periods are subject to change | |
| currency | Three-letter ISO code for the currency of the amount. | |
| transaction_model_id | The model in Stripe associated with this change - either an invoice line item, invoice, invoiceitem, charge, or and so on | |
| debit | The debited account | |
| credit | The credited account | |
| booked_date | The date that the ledger entry is added to the books. | |
| amount | Amount change, expressed in major units of the currency (for example, dollars for USD, or pesos for MXN). | |
| debit_gl_code | The debited general ledger code | |
| credit_gl_code | The credited general ledger code | |
| invoice_id | The invoice associated with this change. Standalone charges or invoice items not associated with an invoice are null. | |
| invoice_line_item_id | The ID of the invoice line_item. | |
| invoice_item_id | The ID of the invoice item | |
| invoice_number | The customer unique number associated with the invoice. | |
| subscription_item_id | The ID of the subscription_item. | |
| price_id | The price associated with this change. Standalone charges or invoice items not associated with a price are null. | |
| product_id | The product associated with this price. | |
| customer_id | The customer associated with this change. | |
| subscription_id | The subscription associated with this change. | |
| charge_id | The charge associated with this change. | |
| refund_id | The refund associated with this change. | |
| dispute_id | The dispute associated with this change. | |
| presentment_currency | The presentment (customer facing) currency of the transaction. | |
| presentment_amount | The presentment (customer facing) amount. |
By Invoice Line Item
API report type: revenue_recognition.debit_credit_by_invoice_line_item.1
| Column Name | Default | Description |
|---|---|---|
| accounting_period | The accounting period | |
| open_accounting_period | The open accounting period; entries in open periods are subject to change | |
| currency | Three-letter ISO code for the currency of the amount. | |
| transaction_model_id | The model in Stripe associated with this change—an invoice line item, invoice, invoice item, charge, and so on. | |
| debit | The debited account | |
| credit | The credited account | |
| booked_date | The date that the ledger entry is added to the books. | |
| amount | Amount change, expressed in major units of the currency (for example, dollars for USD, or pesos for MXN). | |
| debit_gl_code | The debited general ledger code | |
| credit_gl_code | The credited general ledger code | |
| invoice_id | The invoice associated with this change. Standalone charges or invoice items not associated with an invoice are null. | |
| invoice_line_item_id | The ID of the invoice line_item. | |
| invoice_item_id | The ID of the invoice item | |
| subscription_item_id | The ID of the subscription_item. | |
| price_id | The price associated with this change. Standalone charges or invoice items not associated with a price are null. | |
| product_id | The product associated with this price. | |
| customer_id | The customer associated with this change. | |
| subscription_id | The subscription associated with this change. | |
| charge_id | The charge associated with this change. | |
| refund_id | The refund associated with this change. | |
| dispute_id | The dispute associated with this change. | |
| presentment_currency | The presentment (customer facing) currency of the transaction. | |
| presentment_amount | The presentment (customer facing) amount. |
If you encounter any issues, you can contact .