---
search:
  tags:
    - billing
    - GET
seo:
  description: >-
    What are Potential Invoice Details? Returns the complete… Reference for the
    GET /billing/potential-invoices/{id} endpoint in the Leadtime Public API
    API.
sidebar:
  badge: GET
  label: Get potential invoice details
title: Get potential invoice details
type: openapi-operation
---
**What are Potential Invoice Details?**
Returns the complete breakdown of a specific potential invoice, showing all billable items that make up the total amount. This is the detailed view you see when reviewing an invoice before finalizing it. You can see exactly what is being billed, adjust quantities or amounts, and configure additional settings.

**What is included in the details:**
- **Subscription billing rows**: Recurring fees with quantities, unit prices, and payment types (fixed, per-unit, one-time)
- **Time-based tasks**: Completed tickets with logged hours, estimated time, billed time, and hourly rates
- **Express quotations**: Accepted quick quotes from tickets with items, quantities, and unit prices
- **Products**: Items from the product catalog with options, quantities, discounts, and pricing
- **Components**: Project components with time estimates, hourly rates, and nested items
- **Support contingent charges**: Retainer plan charges for Support-type projects, based on allocated hours and pricing for billing periods
- **Manual positions**: Custom billing items (third-party costs, flat fees, interim payments)
- **Leadtime fee settings**: Configuration for adding the Leadtime service fee to the invoice

**Invoice ID Format:**
The invoice ID follows the format: {type}::{projectId}::{dateFrom}::{dateTo}
- Example: SingleProject::0e9d033a-ab41-4212-8637-66c4e3b01fe2::2025-10-01::2025-10-31
- Type: One of Mixed, Subscription, TimeBased, ExpressQuotation, SingleProject, InterimPayment, SupportContingentCharge
- ProjectId: UUID of the project
- DateFrom/DateTo: Dates in YYYY-MM-DD format representing the billing period

**What data is returned:**
- Complete invoice structure with all billable items organized by type
- Billing period (periodFrom, periodTo) and custom billed dates (billedFrom, billedTo)
- Tax calculations (tax amount, reverse charge settings)
- Contact information (contactId for invoice recipient)
- Leadtime fee settings (percentage, method, task distribution, custom title)
- Lists of skipped tasks and express quotations (items excluded from billing)
- All items include detailed pricing, discounts, descriptions (as HTML), and metadata
- Product and component descriptions are converted from ProseMirror IDoc format to HTML

**How to use:**
1. Get the list of potential invoices to find the invoice ID
2. Use this endpoint to get full details of a specific invoice
3. Review all billable items and their amounts
4. Use the PATCH endpoint to adjust settings (billed dates, contact, etc.)
5. Use other endpoints to skip items, add manual positions, or configure fees
6. Once reviewed and adjusted, the invoice can be finalized into an actual invoice document

**Permission requirements:**
Requires Invoices.manage permission and access to the project to view potential invoice details.

<Operation source="api-reference" id="potentialinvoicescontroller-getpotentialinvoicedetails" />