List invoices

Invoice amounts are integer cents in the specified currency. Supports cursor pagination and an optional service_id filter. Creating and paying invoices requires billing:write or reseller:purchase; billing:read alone cannot spend money.

get/v1/invoices

Request

  • Base URL: https://api.trueproxies.com
  • URL: https://api.trueproxies.com/v1/invoices
  • Auth: HTTP bearer

Query parameters

customer_idstring uuid

Owned sub-customer UUID. Resellers only; reads require reseller:read and writes reseller:purchase in addition to the operation scope. X-Customer-Id header is an alternative. Not allowed for me, wallet, trial, API keys, or reseller-management routes.

cursorstring
limitinteger
service_idstring uuid

Only invoices linked to this service and owned by the signed-in customer

status'open' | 'paid' | 'cancelled'

Filter before pagination and counting

kind'wallet_topup' | 'purchase' | 'renewal' | 'topup' | 'upgrade' | 'custom' | 'white_label'

Filter before pagination and counting

Response

ok

limitinteger required
next_cursorstring
totalinteger required

Example response

{
  "items": [
    {
      "reference": "INV-001001"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.