Get an invoice

Retrieve detailed information for a specific invoice by its unique identifier. This endpoint returns comprehensive invoice data including line items, applied credits, totals, and billing period details for both finalized and draft invoices.

Use this endpoint to:

• Display historical invoice details in customer-facing dashboards or billing portals.
• Retrieve current month draft invoices to show customers their month-to-date spend.
• Access finalized invoices for historical billing records and payment reconciliation.
• Validate customer pricing and credit applications for customer support queries.

Key response fields:

Invoice status (DRAFT, FINALIZED, VOID) Billing period start and end dates Total amount and amount due after credits Detailed line items broken down by:

• Customer and contract information
• Invoice line item type
• Product/service name and ID
• Quantity consumed
• Unit and total price
• Time period for usage-based charges
• Applied credits or prepaid commitments

Usage guidelines:

• Draft invoices update in real-time as usage is reported and may change before finalization
• The response includes both usage-based line items (e.g., API calls, data processed) and scheduled charges (e.g., monthly subscriptions, commitment fees)
• Credit and commitment applications are shown as separate line items with negative amounts
• For voided invoices, the response will indicate VOID status but retain all original line item details