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

200

Successfully 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)

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

const response = await fetch("https://leadtime.app/api/public/billing/invoices/497f6eca-6276-4993-bfeb-53cbbbba6f08/settings", {
  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/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
  }
}