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

AuthorizationBearer token (JWT) · headerrequired

Path parameters

idstring<uuid>required

Invoice ID (UUID)

Responses

200

Successfully 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

iconstring | null

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

iconstring | null

Item icon

idstringrequired

Component item ID

namestringrequired

Item name

originalItemIdstring | null

Original item ID from project component

parentIdstring | null

Parent item ID

sortnumberrequired

Sort order

timeFramenumber | null

Time frame in hours

totalEstimatenumber | null

Total estimate in hours

typestringrequired

Item type

Allowed:EpicWorkPackageTodoListTestSuite

namestringrequired

Component name

originalComponentIdstring | null

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

401

Unauthorized - Invalid or missing authentication token

403

Forbidden - Insufficient API scopes or permissions

404

Invoice not found

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

OAuth2 access tokenRemember on this deviceInclude my values in samples

Parameters

idpath*Invoice ID (UUID)

Request

curl -X GET "https://leadtime.app/api/public/billing/invoices/497f6eca-6276-4993-bfeb-53cbbbba6f08" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

const response = await fetch("https://leadtime.app/api/public/billing/invoices/497f6eca-6276-4993-bfeb-53cbbbba6f08", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN"
  }
});

import requests

response = requests.get(
    "https://leadtime.app/api/public/billing/invoices/497f6eca-6276-4993-bfeb-53cbbbba6f08",
    headers={
        "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": [
            {}
          ],
          "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
}