List invoices across subscribers

GET /api/v1/billing/invoices prm_billing

Every invoice the caller may see, in one list, with filters for reconciling a period. A caller without tenant-wide visibility sees only invoices belonging to subscribers in their own manager subtree.

username is populated only on this cross-subscriber list, which joins the subscriber table. The per-subscriber list and the single-invoice fetch leave it empty, because there the subscriber is already known.

At a glance

Authentication: Staff token or session
Requires permission: prm_billing Billing & invoices

Parameters

Parameter	Description
`filter[status]` query · string	Payment status.
`filter[username]` query · string	Narrow to one subscriber by username.
`filter[date_from]` query · string	Inclusive lower bound. A malformed value is a 400, not an ignored filter.
`filter[date_to]` query · string	Inclusive upper bound.
`filter[amount_min]` query · number	Inclusive lower amount bound.
`filter[amount_max]` query · number	Inclusive upper amount bound.

Request

curl -X GET "$BASE/api/v1/billing/invoices" \
  -H "Authorization: Bearer $XR_TOKEN"

Response 200 OK

{
  "data": [
    {
      "id": 51204,
      "user_id": 4711,
      "username": "ahmed",
      "invoice_number": "INV-2026-000512",
      "type": "activation",
      "amount": 171.00,
      "discount": 0.00,
      "vat": 14.00,
      "status": "paid",
      "description": "Home 20M (activate)",
      "payment_method": "manager_balance",
      "due_date": "2026-09-20 00:00:00",
      "paid_on": "2026-09-20 09:15:02",
      "created_by_manager_id": 41,
      "created_by_name": "cairo-reseller",
      "created_at": "2026-09-20 09:15:02"
    }
  ],
  "meta": { "page": 1, "page_size": 50, "total": 1284, "has_next": true }
}

BASE is your tenant host: the same address you sign in on.

Try it on your own network.

50 subscribers for 7 days. You pay nothing.

Try it free Talk to us