List invoices

GET

https://api.talkif.ai/api/v1/billing/invoices

GET

/api/v1/billing/invoices

curl https://api.talkif.ai/api/v1/billing/invoices \
     -H "Authorization: Bearer <token>"

{
  "invoices": [
    {
      "amountDue": 5000,
      "amountPaid": 5000,
      "createdAt": "2026-01-15T10:30:00Z",
      "currency": "usd",
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "status": "paid",
      "stripeInvoiceId": "in_1NVChN2eZvKYlo2CrbkAlkmh",
      "billingReason": "subscription_cycle",
      "dueDate": "2026-02-01T00:00:00Z",
      "hostedInvoiceUrl": "https://invoice.stripe.com/i/acct_1234/inv_5678",
      "invoicePdfUrl": "https://pay.stripe.com/invoice/acct_1234/inv_5678/pdf",
      "paidAt": "2026-01-15T10:35:00Z",
      "periodEnd": "2026-02-01T00:00:00Z",
      "periodStart": "2026-01-01T00:00:00Z"
    }
  ],
  "meta": {
    "limit": 20,
    "offset": 0,
    "total": 142
  }
}

GET /api/v1/billing/invoices

Authentication

AuthorizationBearer

Pass a JWT access token or an API key (prefixed with tif_live_) as a Bearer token.

Query parameters

limitlongOptional

Page size

offsetlongOptionalDefaults to 0

Page offset

Response

Paginated invoice list

invoiceslist of objects

Items on this page

metaobject

Pagination metadata

Errors

401

Unauthorized Error

403

Forbidden Error

429

Too Many Requests Error

500

Internal Server Error