Get organization invoice settings

Retrieves invoice and billing settings for a specific organization. These settings control payment terms, reminder rules, and custom text templates for invoices and reminders.

What are Invoice Settings? Invoice settings allow you to define organization-specific billing parameters that override workspace defaults. This enables customer-specific payment terms, reminder rules, and invoice texts.

What is returned:

• Payment terms:
  • hourRate: Customer-specific hourly rate (used for all billable times)
  • invoiceDueDays: Number of days until payment is due (1-120)
  • invoiceLanguage: Language code for invoice generation (e.g., “en”, “de”)
• Reminder fees:
  • enableInvoiceReminderFee: Whether reminder fees are charged
  • invoiceReminderFee: Amount charged for overdue invoices (0-1000)
• Interest on arrears:
  • enableInvoiceInterest: Whether interest is charged on overdue invoices
  • baseInvoiceInterest: Base interest rate percentage (0-1000)
  • invoiceInterest: Interest rate percentage added to base rate (0-1000)
• Custom text templates: All custom invoice and reminder texts, returned as HTML:
  • withBestRegards: Closing text for invoices
  • invoiceGreeting: Greeting text on invoices
  • invoiceFooter: Footer text on invoices
  • invoiceReminderFeeWarning: Warning about reminder fees
  • firstReminderGreeting: Greeting for first reminder
  • firstReminderFooter: Footer for first reminder
  • secondReminderGreeting: Greeting for second reminder
  • secondReminderFooter: Footer for second reminder
  • cancelationBody: Text for invoice cancellations

Use cases:

• Individual agreements with key clients (longer payment terms, no reminder fees)
• Customer-specific hourly rates (different rates per customer type)
• Goodwill rules for important customers (gentler reminders)
• Stricter rules for risky customers (shorter terms, higher fees)
• International customers (different interest rates, languages, legal requirements)

Note: This endpoint requires the Organizations.view permission. The organization must exist in your workspace and not be deleted. Custom texts are stored internally in IDoc format but returned as HTML for easier consumption.

curl -X GET "https://leadtime.app/api/public/organizations/string/invoice-settings" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

const response = await fetch("https://leadtime.app/api/public/organizations/string/invoice-settings", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN"
  }
});

import requests

response = requests.get(
    "https://leadtime.app/api/public/organizations/string/invoice-settings",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN"
    },
)

{
  "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,
  "hourRate": 75,
  "id": "uuid-123",
  "invoiceDueDays": 30,
  "invoiceInterest": 8,
  "invoiceLanguage": "en",
  "invoiceReminderFee": 5.5
}