CorebanqCorebanq Developer Docs
Tariffsv1Subscription Billing

List subscription charges (fee queue)

Org-wide queue of recurring subscription fee charges with per-status/currency summary. Each row includes customer_name. Requires org-wide tariff read permission.

GET
/v1/tariffs/subscription-charges

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Query Parameters

status?string

Comma-separated status filter; defaults to the attention set

currency?string

ISO 4217 filter

period_key?string

Billing period, e.g. 2026-06

customer_id?string
limit?integer
offset?integer

Response Body

application/json

application/json

curl -X GET "https://example.com/v1/tariffs/subscription-charges"
{
  "charges": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "product_code": "string",
      "customer_id": "160c0c4b-9966-4dc1-a916-8407eb10d74e",
      "customer_name": "string",
      "account_id": "449e7a5c-69d3-4b8a-aaaf-5c9b713ebc65",
      "business_date": "2019-08-24",
      "period_key": "string",
      "amount": "string",
      "currency": "string",
      "txn_id": "3dd6ecc9-94bf-4fc7-98ae-cdbe5b6f62e4",
      "status": "pending",
      "attempts": 0,
      "last_error": "string",
      "created_at": "2019-08-24T14:15:22Z",
      "modified_at": "2019-08-24T14:15:22Z"
    }
  ],
  "summary": [
    {
      "status": "string",
      "currency": "string",
      "count": 0,
      "total_amount": "string"
    }
  ],
  "total_count": 0,
  "limit": 0,
  "offset": 0
}
{
  "code": "tariffs_m.invalid_tariff_data",
  "message": "Invalid tariff data provided"
}
Empty