Skip to content
Create account
or
Sign in
The Stripe Docs logo
/
Ask AI
Create account
Sign in
Get started
Payments
Finance automation
Platforms and marketplaces
Money management
Developer tools
Get started
Payments
Finance automation
Get started
Payments
Finance automation
Platforms and marketplaces
Money management
Overview
Billing
Tax
Reporting
Data
    Overview
    Schema
    Custom reports
    Sigma API
    Create custom reports
    Write queries using Sigma
    Query data across an organisation
    Sync Stripe data
    Access data within a data warehouse
    Export data to a data warehouse
    Export data to cloud storage
    Data management
    Data freshness
    Business and product data use cases
    Import external data
Startup incorporation
HomeFinance automationData

Data freshness

Learn how Sigma and Data Pipeline handle data.

Copy page

Sigma and Data Pipeline allow you to analyse and export the same underlying data that’s accessible through the Stripe API, but through different interfaces. While the Stripe API provides programmatic access to your data, Sigma offers a SQL-based interface for custom queries and analysis, and Data Pipeline enables bulk data exports.

Additionally, Sigma and Data Pipeline provide access to certain data that isn’t available through the Stripe API, such as reports.

Data freshness

Sigma and Data Pipeline make most of your transaction data available to query within one day.

Sigma makes most of your Stripe transaction data available to query within three hours. All API activity is available to query approximately three hours after it occurs. For example, data from 12:00am UTC is available by 3:00am UTC on the same day.

Query data load times

The interface in the Dashboard displays the date and time of the last payments data. You can use data_load_time as a value in your queries to represent when data is most recently processed on your account. For example, if payment tables were last updated on 14/05/2025, the data_load_time is interpreted as 2025-05-11 00:00:00 +0000. At times, Sigma may reflect activity that is more recent than data_load_time. For example, a charge authorised just before midnight, but captured soon after, may show as captured.

Making data available requires additional time. You can use data_load_time as a value in your queries that represents when data is most recently processed on your account. Use this value to dynamically set a date range in your scheduled queries.

For example, consider the following scheduled query that returns a list of balance transactions created one month before data_load_time.

select id, amount, fee, currency from balance_transactions -- this table is the canonical record of changes to your Stripe balance where created < data_load_time and created >= data_load_time - interval '1' month order by created desc limit 10

The following timeline illustrates how this works based on data availability:

DateTimeline for results
2025-05-11
  • data_load_time is interpreted as 2025-05-11
  • The scheduled query includes transaction data through EOD 2025-05-10
  • Query results are available on 2025-05-11 by 2pm UTC

Now, consider the following scheduled query that returns a list of charge_ids and interchange billing amounts associated with each fee balance debit created one month before data_load_time.

select ic.charge_id, ic.billing_currency, ic.billing_amount, ic.balance_transaction_id, ic.balance_transaction_created_at from icplus_fees as ic join balance_transactions as bt on ic.balance_transaction_id = bt.id where bt.created >= data_load_time - interval '1' month and bt.created < data_load_time

If this query is scheduled to recur daily, the following timeline illustrates when you can expect the results:

DateTimeline for results
2025-05-14
  • data_load_time is interpreted as 2025-05-11 00:00:00 +0000
  • The scheduled query includes transaction data through EOD 2025-05-10
  • Query results are available on 2025-05-14 by 2am UTC

Data schema

You can view the complete schema, which closely follows our API conventions, in a split-view format that shows details on table relationships. It displays all the available data that you can use in your queries, organised by category. Each category contains a set of tables that represents the available data. Many tables correspond to specific API objects, with each column representing a reported attribute. For example, the charges table represents information about Charge objects, which appears in the Payments section of the Dashboard.

You can select a table to expand it and reveal its available columns, along with a description of the type of data it contains (for example, Boolean , Varchar, and Foreign key). Hover the cursor over any column to reveal a description. Use the search field at the top of the schema to find specific tables and columns. When writing queries, refer to our API reference for additional context and values.

Dataset freshness

View the following tables for information on data freshness for specific datasets:

DatasetTable NameSigma FreshnessSDP Freshness
billingcoupons39
billingcoupons_currency_options39
billingcoupons_metadata39
billingcredit_note_discount_amounts39
billingcredit_note_line_item_discount_amounts39
billingcredit_note_line_item_tax_amounts39
billingcredit_note_line_items39
billingcredit_note_tax_amounts39
billingcredit_notes39
billingcredit_notes_metadata39
billingdiscounts39
billinginvoice_custom_fields39
billinginvoice_customer_tax_ids39
billinginvoice_items39
billinginvoice_items_metadata39
billinginvoice_line_item_discount_amounts39
billinginvoice_line_item_tax_amounts39
billinginvoice_line_items39
billinginvoice_payments39
billinginvoice_shipping_cost_taxes39
billinginvoices39
billinginvoices_metadata39
billingplans39
billingplans_metadata39
billingprice_tiers39
billingprices39
billingprices_currency_options39
billingprices_metadata39
billingproducts39
billingproducts_metadata39
billingpromotion_codes39
billingquotes39
billingsubscription_items39
billingsubscription_items_metadata39
billingsubscription_schedule_phase_add_invoice_items39
billingsubscription_schedule_phase_configuration_items39
billingsubscription_schedule_phases39
billingsubscription_schedule_phases_metadata39
billingsubscription_schedules39
billingsubscription_schedules_metadata39
billingsubscriptions39
billingsubscriptions_metadata39
billingtax_rates39
billingtax_rates_metadata39
billingusage_records39
checkoutcheckout_custom_fields39
checkoutcheckout_line_items39
checkoutcheckout_sessions39
checkoutpayment_links39
connectaccounts39
connectaccounts_metadata39
connect-feesapplication_fee_refunds39
connect-feesapplication_fee_refunds_metadata39
connect-feesapplication_fees39
cryptocrypto_onramp_sessions39
customerscustomer_balance_transactions39
customerscustomer_balance_transactions_metadata39
customerscustomer_cash_balance_transactions39
customerscustomer_tax_ids39
customerscustomers39
customerscustomers_metadata39
issuingissuing_authorizations39
issuingissuing_authorizations_metadata39
issuingissuing_cardholders39
issuingissuing_cardholders_metadata39
issuingissuing_cards39
issuingissuing_cards_metadata39
issuingissuing_disputes39
issuingissuing_network_tokens39
issuingissuing_transactions39
issuingissuing_transactions_metadata39
paymentsbalance_transaction_fee_details39
paymentsbalance_transactions39
paymentscharges39
paymentscharges_metadata39
paymentsdisputes39
paymentsdisputes_enhanced_eligibility39
paymentsdisputes_metadata39
paymentsexternal_account_bank_accounts39
paymentsexternal_account_cards39
paymentspayment_intents39
paymentspayment_intents_metadata39
paymentspayment_method_details39
paymentspayment_methods39
paymentspayment_methods_metadata39
paymentspayment_reviews39
paymentsrefunds39
paymentsrefunds_metadata39
paymentsrule_decisions39
paymentssetup_attempts39
paymentssetup_intents39
paymentssetup_intents_metadata39
paymentssources39
paymentssources_metadata39
Was this page helpful?
YesNo
Need help? Contact Support.
Join our early access programme.
Check out our changelog.
Questions? Contact Sales.
LLM? Read llms.txt.
Powered by Markdoc