Skip to main content
GET /v1/billing/invoices
Returns invoices for your tenant’s billing history. Each invoice includes the amount, currency, payment status, and links to download the PDF or receipt.

​
Response

Returns an array of invoice objects.
​
id
string
Invoice identifier.
​
invoice_number
string
Human-readable invoice number.
​
status
string
Payment status: paid, open, void, or uncollectible.
​
total
integer
Total amount in the smallest currency unit (e.g., cents for USD).
​
amount
integer
Amount due in the smallest currency unit.
​
currency
string
ISO 4217 currency code (e.g., usd, ngn).
​
created_at
string
ISO 8601 timestamp when the invoice was created.
​
issued_at
string
ISO 8601 timestamp when the invoice was finalized and sent.
​
due_at
string
ISO 8601 timestamp for the payment due date.
​
full_pdf_url
string
URL to download the full invoice PDF.
​
receipt_url
string
URL to view the payment receipt (available for paid invoices).
curl https://api.truthlocks.com/v1/billing/invoices \
  -H "X-API-Key: tl_live_..."

[
  {
    "id": "inv_abc123",
    "invoice_number": "TL-2026-0042",
    "status": "paid",
    "total": 29900,
    "amount": 29900,
    "currency": "usd",
    "created_at": "2026-03-01T00:00:00Z",
    "issued_at": "2026-03-01T00:00:00Z",
    "due_at": "2026-03-15T00:00:00Z",
    "full_pdf_url": "https://pay.stripe.com/invoice/acct_.../inv_.../pdf",
    "receipt_url": "https://pay.stripe.com/receipts/..."
  }
]