Get invoice settings

Returns invoice-specific settings including language, reminder fees, interest rates, and custom text templates. Invoice settings can override organization or workspace defaults.

What is returned:

Invoice-specific settings (language, reminder fees, interest rates)
Parent settings (from organization or workspace) for reference
Custom text templates (returned as HTML) for:
- Closing salutation (withBestRegards)
- Invoice greeting
- Invoice footer
- Reminder fee warning
- First and second reminder greetings and footers
- Cancellation body

Settings hierarchy: Invoice settings override organization settings, which override workspace defaults. If a setting is null at the invoice level, the parent setting is used.

GET/billing/invoices/{id}/settings

Authorization

AuthorizationOAuth2 access token · headerrequired

Scopes:api:read

AuthorizationBearer token (JWT) · headerrequired

Path parameters

idstring<uuid>required

Invoice ID (UUID)

Responses

200Successfully retrieved invoice settings

baseInvoiceInterestobject | nullrequired

Base invoice interest

customTextsobjectrequired

Custom invoice text templates (returned as HTML)

Show properties

cancelationBodystring | null

firstReminderFooterstring | null

firstReminderGreetingstring | null

invoiceFooterstring | null

invoiceGreetingstring | null

invoiceReminderFeeWarningstring | null

secondReminderFooterstring | null

secondReminderGreetingstring | null

withBestRegardsstring | null

enableInvoiceInterestobject | nullrequired

Enable invoice interest

enableInvoiceReminderFeeobject | nullrequired

Enable invoice reminder fee

idstringrequired

Invoice ID

invoiceInterestobject | nullrequired

Invoice interest

invoiceLanguageobject | nullrequired

Invoice language

invoiceReminderFeeobject | nullrequired

Invoice reminder fee

parentSettingsobjectrequired

Parent settings (from organization or workspace)

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/settings" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

const response = await fetch("https://leadtime.app/api/public/billing/invoices/%3Cuuid%3E/settings", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN"
  }
});

import requests

response = requests.get(
    "https://leadtime.app/api/public/billing/invoices/%3Cuuid%3E/settings",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN"
    },
)

Response

{
  "baseInvoiceInterest": 2.5,
  "customTexts": {
    "cancelationBody": "string",
    "firstReminderFooter": "string",
    "firstReminderGreeting": "string",
    "invoiceFooter": "string",
    "invoiceGreeting": "string",
    "invoiceReminderFeeWarning": "string",
    "secondReminderFooter": "string",
    "secondReminderGreeting": "string",
    "withBestRegards": "string"
  },
  "enableInvoiceInterest": true,
  "enableInvoiceReminderFee": true,
  "id": "uuid-123",
  "invoiceInterest": 8,
  "invoiceLanguage": "en",
  "invoiceReminderFee": 5.5,
  "parentSettings": {
    "baseInvoiceInterest": 2.5,
    "enableInvoiceInterest": true,
    "enableInvoiceReminderFee": true,
    "invoiceInterest": 8,
    "invoiceLanguage": "en",
    "invoiceReminderFee": 5.5
  }
}