Skip to content
Leadtime
English
EnglishDeutschNot translated
Esc
↑↓navigate↵open⌘Jpreview

Get invoice details

Returns complete details of an existing invoice, including all billable items, financial totals, and payment tracking information.

What is returned:

  • Invoice identification (ID, number, type, status)
  • Project reference and billing period (billedFrom, billedTo)
  • All billable items:
    • Tasks with time tracking and hourly rates
    • Products with options, quantities, and pricing
    • Components with nested items and time estimates
    • Subscriptions (fixed, variable, one-time payments)
    • Express quotations with items and options
    • Support contingent charges (retainer plan charges for Support-type projects)
    • Support contingent usage (compensation/deductions from support contingents, negative amounts)
    • Manual positions (custom billing items)
  • Financial totals:
    • Net amount (before taxes and fees)
    • VAT amount and percentage
    • Leadtime fee (if applicable)
    • Gross amount (after taxes)
    • Full total (including all fees)
  • Payment tracking:
    • Due date and overdue status
    • Sent dates and recipients
    • Reminder dates (first and second)
    • Payment received date
    • Cancellation information
  • Overdue fees and interest calculations

Description fields: All description fields (products, components, manual positions, express quotations) are returned as HTML format for easy display in web applications.

Use cases:

  • View complete invoice breakdown for accounting
  • Display invoice details in customer portals
  • Generate custom invoice documents
  • Track payment status and overdue amounts
  • Audit invoice contents and calculations
GET/billing/invoices/{id}
Authorization
AuthorizationOAuth2 access token · headerrequired
Scopes:api:read
or
AuthorizationBearer token (JWT) · headerrequired
Path parameters
idstring<uuid>required
Invoice ID (UUID)
Responses
200Successfully retrieved invoice details
billedFromstringrequired
Billing period start date
billedTostringrequired
Billing period end date
bruttonumberrequired
Gross amount (after taxes)
cancelationSentAtobject
Cancellation sent date
cancelationSentByobject
User ID who sent cancellation
cancelationSentContactIdobject
Cancellation contact ID
cancelationSentTypestringrequired
How cancellation was sent
Allowed:ManualEmail
componentsCountnumberrequired
Number of components billed
componentsSumnumberrequired
Total amount from components
contactIdobject
Invoice contact ID
createdAtstringrequired
Invoice creation date
dueDateobject
Payment due date
expressQuotationsInvoiceExpressQuotationDto[]required
Express quotations
Show properties
Array of InvoiceExpressQuotationDto
acceptedAtstringrequired
Accepted date
acceptedByNamestringrequired
Accepted by user name
amountnumberrequired
Total amount
fullNumberstringrequired
Full quotation number
idstringrequired
Express quotation ID
itemsInvoiceExpressQuotationItemDto[]required
Quotation items
Show properties
Array of InvoiceExpressQuotationItemDto
descriptionstringrequired
Item description as HTML
optionsInvoiceExpressQuotationItemOptionDto[]required
Item options
Show properties
Array of InvoiceExpressQuotationItemOptionDto
titlestringrequired
Option title
totalPricenumberrequired
Total price
unitPricenumberrequired
Unit price
ordernumberrequired
Order
quantitynumberrequired
Quantity
titlestringrequired
Item title
totalPricenumberrequired
Total price
unitstringrequired
Unit type
unitPricenumberrequired
Unit price
quotationIdstringrequired
Quotation ID
quotationShortNumbernumberrequired
Quotation short number
taskIdstringrequired
Task ID
taskShortNumbernumberrequired
Task short number
titlestringrequired
Quotation title
firstReminderAtobject
First reminder sent date
firstReminderContactIdobject
First reminder contact ID
firstReminderSentByobject
User ID who sent first reminder
firstReminderTypestringrequired
How first reminder was sent
Allowed:ManualEmail
fixedSubscriptionsInvoiceFixedSubscriptionDto[]required
Fixed subscriptions
Show properties
Array of InvoiceFixedSubscriptionDto
amountnumberrequired
Subscription amount
idstringrequired
Subscription billing ID
titlestringrequired
Subscription title
fullTotalnumberrequired
Full total including all fees
hourRatenumberrequired
Hourly rate used for time-based billing
idstringrequired
Invoice ID (UUID)
includedTypesnumber[]required
Included invoice types
invoiceComponentsInvoiceComponentDto[]required
Invoice components
Show properties
Array of InvoiceComponentDto
amountnumberrequired
Total amount after discount
amountWithoutDiscountnumberrequired
Amount before discount
descriptionstringrequired
Component description as HTML
discountAmountnumberrequired
Discount amount
discountTypestringrequired
Discount type
Allowed:FixedPercentage
hourRatenumberrequired
Hourly rate
iconobject
Component icon
idstringrequired
Invoice component ID
itemsInvoiceComponentItemDto[]required
Component items
Show properties
Array of InvoiceComponentItemDto
amountnumberrequired
Total amount
childrenInvoiceComponentItemDto[]
Nested child items
Show properties
Array of InvoiceComponentItemDto
Circular reference to InvoiceComponentItemDto.
descriptionstringrequired
Item description as HTML
hourRatenumberrequired
Hourly rate
iconobject
Item icon
idstringrequired
Component item ID
namestringrequired
Item name
originalItemIdobject
Original item ID from project component
parentIdobject
Parent item ID
sortnumberrequired
Sort order
timeFrameobject
Time frame in hours
totalEstimateobject
Total estimate in hours
typestringrequired
Item type
Allowed:EpicWorkPackageTodoListTestSuite
namestringrequired
Component name
originalComponentIdobject
Original component ID from project
sortnumberrequired
Sort order
totalTimeFramenumberrequired
Total time frame in hours
invoiceProductsInvoiceProductDto[]required
Invoice products
Show properties
Array of InvoiceProductDto
basePriceFixednumberrequired
Base price before discounts
categoryIdstringrequired
Product category ID
descriptionobject
Product description as HTML
fixedDiscountAmountnumberrequired
Discount amount
fixedDiscountTypestringrequired
Discount type
Allowed:FixedPercentage
fixedDiscountValuenumberrequired
Discount value
idstringrequired
Invoice product ID
logoIdobject
Product logo file ID
namestringrequired
Product name
optionsInvoiceProductOptionDto[]required
Product options
Show properties
Array of InvoiceProductOptionDto
idstringrequired
Option ID
namestringrequired
Option name
originalOptionIdobject
Original option ID from catalog
sortnumberrequired
Sort order
valuesInvoiceProductOptionValueDto[]required
Available option values
Show properties
Array of InvoiceProductOptionValueDto
extraPriceFixedobject
Extra price for this option value
idstringrequired
Option value ID
namestringrequired
Option value name
originalValueIdobject
Original option value ID from catalog
sortnumberrequired
Sort order
originalProductIdobject
Original product ID from catalog
priceFixednumberrequired
Price after discounts
quantitynumberrequired
Quantity
sortnumberrequired
Sort order
totalPricenumberrequired
Total price (priceFixed * quantity)
invoiceProductsCountnumberrequired
Number of products billed
invoiceProductsSumnumberrequired
Total amount from products
isOverduebooleanrequired
Whether invoice is overdue
leadtimeFeenumberrequired
Leadtime fee amount
leadtimeFeeIncludedbooleanrequired
Whether Leadtime fee is included
leadtimeFeeMethodstringrequired
Leadtime fee calculation method
Allowed:SeparateRowTasksDistribution
leadtimeFeePercentnumberrequired
Leadtime fee percentage
leadtimeRowCustomTitleobject
Custom title for Leadtime fee row
manualRowsInvoiceManualPositionDto[]required
Manual billing positions
Show properties
Array of InvoiceManualPositionDto
amountnumberrequired
Total amount
categoryNameobject
Category name
descriptionobject
Description as HTML
discountAmountnumber
Discount amount
discountTypestring
Discount type
Allowed:FixedPercentage
discountValuenumber
Discount value
idstringrequired
Manual position ID
interimPaymentIdobject
Interim payment ID
projectManualPositionIdobject
Project manual position ID
titlestringrequired
Position title
typestring
Manual position type
Allowed:manualprojectinterimPaymentinterimPaymentDiscount
nettonumberrequired
Net amount (before taxes and fees)
numberstringrequired
Invoice number
oneTimePaymentsInvoiceOneTimePaymentDto[]required
One-time payments
Show properties
Array of InvoiceOneTimePaymentDto
amountnumberrequired
Total amount
idstringrequired
One-time payment ID
pricenumberrequired
Price per unit
quantitynumberrequired
Quantity
titlestringrequired
Payment title
overDueDaysnumberrequired
Number of days overdue
overdueInterestnumberrequired
Overdue interest amount
overdueInterestDaysnumberrequired
Overdue interest days
overdueInterestPercentnumberrequired
Overdue interest percentage
overdueReminderFeenumberrequired
Overdue reminder fee
paidAtobject
Payment received date
paidRuntimeobject
Payment runtime in days
potentialOverdueInterestnumberrequired
Potential overdue interest
potentialOverdueReminderFeenumberrequired
Potential overdue reminder fee
projectIdstringrequired
Project ID
reverseVatbooleanrequired
Whether reverse VAT charge applies
secondReminderAtobject
Second reminder sent date
secondReminderContactIdobject
Second reminder contact ID
secondReminderSentByobject
User ID who sent second reminder
secondReminderTypestringrequired
How second reminder was sent
Allowed:ManualEmail
sentAtobject
Invoice sent date
sentByobject
User ID who sent the invoice
sentToContactIdobject
Contact ID who received the invoice
sentTypestringrequired
How invoice was sent
Allowed:ManualEmail
statusstringrequired
Invoice status
Allowed:NewSentPaidCancelled
statusChangedAtobject
Status change date
supportContingentChargesInvoiceSupportContingentChargeDto[]required
Support contingent charges billed on this invoice
Show properties
Array of InvoiceSupportContingentChargeDto
frequencynumberrequired
Billing frequency in months. Determines how often this contingent is charged (e.g., 1 = monthly, 3 = quarterly)
hourRatenumberrequired
Hourly rate used for calculating the price (in organization currency)
hoursIncludednumberrequired
Number of hours included in this billing period
idstringrequired
Invoice support contingent charge ID
periodEndstringrequired
Billing period end date (ISO 8601 date string, YYYY-MM-DD format)
periodStartstringrequired
Billing period start date (ISO 8601 date string, YYYY-MM-DD format)
pricenumberrequired
Total price for this billing period (in organization currency)
supportContingentIdstringrequired
Support contingent ID (UUID) that this charge is based on
titlestringrequired
Title of the support contingent
transferablebooleanrequired
Whether unused hours from this period can be transferred to future periods
supportContingentChargesCountnumberrequired
Number of support contingent charges billed
supportContingentChargesSumnumberrequired
Total amount from support contingent charges
tasksInvoiceTaskDto[]required
Billed tasks
Show properties
Array of InvoiceTaskDto
amountnumberrequired
Total amount
billedTimenumberrequired
Billed time in hours
estimatedTimenumberrequired
Estimated time in hours
idstringrequired
Task ID
leadtimeFeeTimenumberrequired
Leadtime fee time in hours
spentTimenumberrequired
Time spent in hours
taskShortNumbernumberrequired
Task short number
taskTypeIdstringrequired
Task type ID
titlestringrequired
Task title
totalHoursnumberrequired
Total hours (billed + leadtime fee)
tasksCountnumberrequired
Number of tasks billed
tasksHoursBillednumberrequired
Total hours billed from tasks
tasksSumnumberrequired
Total amount from tasks
typestringrequired
Invoice type
Allowed:MixedSubscriptionTimeBasedExpressQuotationSingleProjectInterimPaymentSupportContingentCharge
variableSubscriptionsInvoiceVariableSubscriptionDto[]required
Variable subscriptions
Show properties
Array of InvoiceVariableSubscriptionDto
amountnumberrequired
Total amount
idstringrequired
Subscription billing ID
pricenumberrequired
Price per unit
quantitynumberrequired
Quantity (number of units)
titlestringrequired
Subscription title
vatnumberrequired
VAT percentage
vatAmountnumberrequired
VAT amount
401Unauthorized - Invalid or missing authentication token
403Forbidden - Insufficient API scopes or permissions
404Invoice not found
Request
curl -X GET "https://leadtime.app/api/public/billing/invoices/%3Cuuid%3E" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
Response
{
  "billedFrom": "2025-01-01",
  "billedTo": "2025-01-31",
  "brutto": 11900,
  "cancelationSentAt": "2025-01-20T10:00:00Z",
  "cancelationSentBy": "123e4567-e89b-12d3-a456-426614174000",
  "cancelationSentContactId": "123e4567-e89b-12d3-a456-426614174000",
  "cancelationSentType": "Email",
  "componentsCount": 3,
  "componentsSum": 12000,
  "contactId": "123e4567-e89b-12d3-a456-426614174000",
  "createdAt": "2025-01-15T10:00:00Z",
  "dueDate": "2025-02-15",
  "expressQuotations": [
    {
      "acceptedAt": "2025-01-15T10:00:00Z",
      "acceptedByName": "John Doe",
      "amount": 500,
      "fullNumber": "EQ-456",
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "items": [
        {
          "description": "<p>Extra development work</p>",
          "options": [
            {
              "title": "Priority Support",
              "totalPrice": 50,
              "unitPrice": 50
            }
          ],
          "order": 1,
          "quantity": 5,
          "title": "Additional Development Hours",
          "totalPrice": 500,
          "unit": "Hours",
          "unitPrice": 100
        }
      ],
      "quotationId": "123e4567-e89b-12d3-a456-426614174000",
      "quotationShortNumber": 456,
      "taskId": "123e4567-e89b-12d3-a456-426614174000",
      "taskShortNumber": 123,
      "title": "Quick Add-on Development"
    }
  ],
  "firstReminderAt": "2025-02-20T10:00:00Z",
  "firstReminderContactId": "123e4567-e89b-12d3-a456-426614174000",
  "firstReminderSentBy": "123e4567-e89b-12d3-a456-426614174000",
  "firstReminderType": "Email",
  "fixedSubscriptions": [
    {
      "amount": 500,
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "title": "Monthly Support Package"
    }
  ],
  "fullTotal": 12400,
  "hourRate": 100,
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "includedTypes": [
    "Mixed"
  ],
  "invoiceComponents": [
    {
      "amount": 12000,
      "amountWithoutDiscount": 13000,
      "description": "<p>Backend API development</p>",
      "discountAmount": 1000,
      "discountType": "Percentage",
      "hourRate": 100,
      "icon": "⚙️",
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "items": [
        {
          "amount": 4000,
          "children": [
            null
          ],
          "description": "<p>Implement user authentication system</p>",
          "hourRate": 100,
          "icon": "🔐",
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "name": "User Authentication",
          "originalItemId": "123e4567-e89b-12d3-a456-426614174000",
          "parentId": "123e4567-e89b-12d3-a456-426614174000",
          "sort": 1,
          "timeFrame": 40,
          "totalEstimate": 40,
          "type": "WorkPackage"
        }
      ],
      "name": "Backend Development",
      "originalComponentId": "123e4567-e89b-12d3-a456-426614174000",
      "sort": 1,
      "totalTimeFrame": 120
    }
  ],
  "invoiceProducts": [
    {
      "basePriceFixed": 1000,
      "categoryId": "123e4567-e89b-12d3-a456-426614174000",
      "description": "<p>Complete website development package</p>",
      "fixedDiscountAmount": 100,
      "fixedDiscountType": "Percentage",
      "fixedDiscountValue": 10,
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "logoId": "123e4567-e89b-12d3-a456-426614174000",
      "name": "Website Development Package",
      "options": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "name": "Size",
          "originalOptionId": "123e4567-e89b-12d3-a456-426614174000",
          "sort": 1,
          "values": [
            {
              "extraPriceFixed": 50,
              "id": "123e4567-e89b-12d3-a456-426614174000",
              "name": "Large",
              "originalValueId": "123e4567-e89b-12d3-a456-426614174000",
              "sort": 1
            }
          ]
        }
      ],
      "originalProductId": "123e4567-e89b-12d3-a456-426614174000",
      "priceFixed": 900,
      "quantity": 1,
      "sort": 1,
      "totalPrice": 900
    }
  ],
  "invoiceProductsCount": 5,
  "invoiceProductsSum": 5000,
  "isOverdue": false,
  "leadtimeFee": 500,
  "leadtimeFeeIncluded": true,
  "leadtimeFeeMethod": "TasksDistribution",
  "leadtimeFeePercent": 10,
  "leadtimeRowCustomTitle": "Service Fee",
  "manualRows": [
    {
      "amount": 200,
      "categoryName": "Licenses",
      "description": "<p>Annual license fee</p>",
      "discountAmount": 0,
      "discountType": "Fixed",
      "discountValue": 0,
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "interimPaymentId": "123e4567-e89b-12d3-a456-426614174000",
      "projectManualPositionId": "123e4567-e89b-12d3-a456-426614174000",
      "title": "Third-party API License",
      "type": "manual"
    }
  ],
  "netto": 10000,
  "number": "ACME01-2510-001",
  "oneTimePayments": [
    {
      "amount": 500,
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "price": 500,
      "quantity": 1,
      "title": "Setup Fee"
    }
  ],
  "overDueDays": 0,
  "overdueInterest": 0,
  "overdueInterestDays": 0,
  "overdueInterestPercent": 0,
  "overdueReminderFee": 0,
  "paidAt": "2025-01-20T10:00:00Z",
  "paidRuntime": 5,
  "potentialOverdueInterest": 0,
  "potentialOverdueReminderFee": 0,
  "projectId": "123e4567-e89b-12d3-a456-426614174000",
  "reverseVat": false,
  "secondReminderAt": "2025-03-01T10:00:00Z",
  "secondReminderContactId": "123e4567-e89b-12d3-a456-426614174000",
  "secondReminderSentBy": "123e4567-e89b-12d3-a456-426614174000",
  "secondReminderType": "Email",
  "sentAt": "2025-01-15T10:00:00Z",
  "sentBy": "123e4567-e89b-12d3-a456-426614174000",
  "sentToContactId": "123e4567-e89b-12d3-a456-426614174000",
  "sentType": "Email",
  "status": "New",
  "statusChangedAt": "2025-01-15T10:00:00Z",
  "supportContingentCharges": [
    {
      "frequency": 1,
      "hourRate": 10,
      "hoursIncluded": 50,
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "periodEnd": "2025-08-31",
      "periodStart": "2025-08-01",
      "price": 500,
      "supportContingentId": "123e4567-e89b-12d3-a456-426614174000",
      "title": "Monthly Support Retainer",
      "transferable": true
    }
  ],
  "supportContingentChargesCount": 1,
  "supportContingentChargesSum": 500,
  "tasks": [
    {
      "amount": 850,
      "billedTime": 8.5,
      "estimatedTime": 8,
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "leadtimeFeeTime": 0.5,
      "spentTime": 8.5,
      "taskShortNumber": 123,
      "taskTypeId": "123e4567-e89b-12d3-a456-426614174000",
      "title": "Implement user authentication",
      "totalHours": 9
    }
  ],
  "tasksCount": 10,
  "tasksHoursBilled": 80.5,
  "tasksSum": 8050,
  "type": "Mixed",
  "variableSubscriptions": [
    {
      "amount": 1000,
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "price": 100,
      "quantity": 10,
      "title": "Per-User License"
    }
  ],
  "vat": 19,
  "vatAmount": 1900
}