Stripe Invoice Line Items Explained: Fields, API & Export
Aug 3, 2026 · Matt · Updated Sep 22, 2026
A Stripe invoice line item is one billed row inside a Stripe invoice. It records the amount and currency plus context such as description, quantity, service period, pricing, discounts, taxes, and the parent that generated the row. Use line items when you need product-, price-, proration-, or service-period detail that an invoice total cannot provide.
Stripe Invoice Line Items: Quick Reference
Question | Answer |
|---|---|
What is it? | One billed row inside a Stripe invoice. |
What creates it? | An invoice item or subscription item. |
How do you retrieve it? | Use the invoice lines collection or GET /v1/invoices/:id/lines. |
Which fields matter? | Amount, currency, description, period, pricing, quantity, discounts, taxes, and parent. |
Can the Dashboard export it? | The invoice CSV is invoice-level, not a dedicated one-row-per-line-item export. |
What is it useful for? | Product and price revenue, prorations, service periods, and invoice composition. |
For the current object schema, see Stripe's invoice line item API reference.
Invoice Line Item vs Invoice Item: What's the Difference?
An invoice item is a pending or one-time billing item that can be added to an invoice. An invoice line item is the billed row that appears on the invoice after Stripe applies a subscription item, invoice item, or proration. In other words, invoice items help create charges before or during invoicing; invoice line items record what the invoice actually contains.
Can you export invoice line items from Stripe?
Based on the current Stripe dashboard export options, Stripe does not provide a dedicated invoice line items CSV export from the UI.
An invoice CSV export gives you one row per invoice. Even if the dashboard shows a Line items column or invoice detail that references billed rows, that is not the same as having a CSV where each invoice line item is its own row.
So if your reporting depends on true line-item detail, the Stripe dashboard CSV exports are limited.
This is one of the main reasons manual CSV workflows become difficult for:
revenue by product reporting
price-level analysis
proration analysis
detailed subscription billing analysis
Stripe Invoice Line Items API: How to Retrieve Them
Retrieving an invoice returns a lines collection containing the total count and an initial set of line items. To retrieve the full paginated list, use GET /v1/invoices/:id/lines. Stripe documents the endpoint, pagination parameters, and returned line-item objects in its invoice line item retrieval guide.
Stripe Invoice Line Item Fields for Reporting
The most useful fields depend on the question you are answering. These current API paths cover the core reporting relationships and measures:
Stripe API field | What it tells you | Reporting use |
|---|---|---|
amount, currency | The line amount and currency | Line-level amounts and currency grouping |
description | The human-readable line description | Labels and manual review |
pricing.price_details.product, pricing.price_details.price | Product and price IDs when price details are present | Product and price grouping |
pricing.unit_amount_decimal, quantity | Unit amount and quantity | Price and quantity analysis |
period.start, period.end | The service period covered by the line | Period-based and revenue-timing analysis |
parent.type and parent details | The invoice item or subscription item that generated the line, including proration context | Origin and proration classification |
discount_amounts, taxes | Line-level discount and tax details | Gross-to-net detail |
id, invoice, metadata | The line ID, related invoice, and structured custom context | Joins, deduplication, and custom labels |
Why Stripe invoice line items matter
Teams often want answers to questions such as:
how much revenue did a specific product generate?
which price was billed?
how should prorations be handled?
what exactly made up an invoice total?
Those are usually invoice line item questions.
If you only look at invoice-level totals, you lose the row-level detail needed for deeper billing analysis.
For a worked reporting method, see how to calculate revenue by product in Stripe.
How invoice line items relate to other Stripe objects
Stripe billing data is easier to understand when the object relationships are clear. The Stripe reporting data model guide shows how invoice lines connect to invoices, products, prices, payments, and balance transactions.
Stripe Object | What It Represents |
|---|---|
Invoice | The overall billing record |
Invoice line item | A billed row within the invoice |
Product | What is being sold conceptually |
Price | The specific pricing record used for billing |
Subscription | The recurring billing relationship |
A simple way to think about it:
the product is what you sell
the price is how that product is priced
the subscription is the recurring billing relationship
the invoice is the billing document
the invoice line item is the billed row that appears on that invoice
Service-period fields also affect monthly versus quarterly revenue reporting.
Where do invoice line items appear in the Stripe UI?
In the current Stripe dashboard, invoice line item information appears within invoice views, but Stripe does not expose a dedicated primary export for invoice line items.
You can see invoice-related data through:
Invoices
invoice detail pages
invoice columns that may reference line items in the dashboard UI
But this is the important limitation:
the invoice CSV export is invoice-level
it does not provide a true one-row-per-line-item export from the dashboard
That means the dashboard can show invoice line item information visually without giving you a normalized invoice line items CSV.
Why this limitation matters for reporting
If you want to answer questions like:
how much revenue came from one product?
how much revenue came from one price?
which invoice rows were prorations?
then invoice-level exports are often not enough.
Without true invoice line item exports, teams usually have to approximate the answer by combining:
invoices
products
prices
subscriptions
payments or refunds
That can work for basic analysis, but it is harder to make accurate and repeatable.
How do you analyze invoice line item data in Google Sheets?
A typical workflow depends on whether you are using only dashboard CSVs or richer Stripe data.
Using manual Stripe CSV exports
Step 1: Export Invoices
Step 2: Export Products and Prices
Step 3: Export Subscriptions if recurring billing context is needed
Step 4: Import the CSVs into Google Sheets
Step 5: Approximate product- and billing-level analysis from the available exports
This can support lighter reporting, but it does not provide true line-item rows.
Using richer Stripe data
If your workflow includes Stripe data beyond the dashboard CSV exports, invoice line items become much more useful for:
revenue by product
revenue by price
proration analysis
customer billing detail
Common points of confusion
Invoice totals are not the same as invoice line items
The invoice total is the final billed total. Invoice line items are the rows that make up that total.
Products and prices are not the same as invoice line items
Products and prices define what can be billed. Invoice line items record what was actually billed on a specific invoice.
The Stripe dashboard can show line item information without exporting it cleanly
This is a common source of confusion. Users may see line item references in the UI and assume a line-item CSV export exists, but the current dashboard exports do not provide that as a dedicated CSV.
Sources
How SyncStaq helps with invoice line item reporting
Manual Stripe CSV exports are useful for basic billing analysis, but they do not expose every dataset needed for advanced reporting.
SyncStaq fills that gap by syncing invoice line item data directly into Google Sheets on a schedule. Unlike the Stripe dashboard CSV exports, SyncStaq provides a dedicated invoice line items tab with row-level billing data that enables line-item-level reporting such as:
revenue by product
revenue by price
subscription billing analysis
invoice composition analysis
repeatable finance reporting
Below are some of the fields available on the invoice line items tab:
Line Description
Line Amount
Quantity
Subtotal
Discount Amount (total)
Product ID
Product Name
Product Description
Invoice Status
You can review the tab structure in the public sample sheet and see how it fits into a comprehensive Stripe reporting framework.
Key takeaways
A Stripe invoice line item is an individual billed row within an invoice.
Invoice line items are often the key layer for product-, price-, and proration-level analysis.
The current Stripe dashboard does not provide a dedicated invoice line items CSV export.
This limitation is one reason advanced Stripe reporting becomes difficult with manual CSV workflows alone.
Stop rebuilding Stripe reports from CSV exports. SyncStaq keeps Stripe billing data synced into Google Sheets every hour, so you can use Sheets for reporting, reconciliation, and analysis without maintaining custom scripts. Start a 14-day free trial.