Portfolio usage and billing for a month

GET

/api/reseller/usage

Returns exact usage across the whole portfolio for the given (or current) month from the call ledger, plus the reseller's cost, revenue (packages + topups + overage), profit, and margin.

Request

Authorization

API Key

Add parameter in cookie

session

Example:

session: ********************

Query Params

Responses

🟢200

application/json

Usage summary and per-customer breakdown.

Bodyapplication/json

🟠401

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.snakk.ai/api/reseller/usage?year=&month='

Response Example

{
    "year": 0,
    "month": 0,
    "summary": {
        "tenant_count": 0,
        "active_count": 0,
        "total_minutes_this_month": 0,
        "total_calls_this_month": 0,
        "cost_nok": 0,
        "effective_rate": 0,
        "billing_breakdown": [
            {
                "property1": "string",
                "property2": "string"
            }
        ],
        "revenue_nok": 0,
        "revenue_packages_nok": 0,
        "revenue_topups_nok": 0,
        "revenue_overage_nok": 0,
        "profit_nok": 0,
        "margin_pct": 0,
        "unpriced_active_count": 0
    },
    "per_tenant": [
        {
            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
            "name": "string",
            "is_active": true,
            "minutes_used_this_month": 0,
            "calls_this_month": 0,
            "package_name": "string",
            "included_minutes": 0,
            "package_price_nok": 0,
            "overage_strategy": "block",
            "overage_rate_nok": 0
        }
    ]
}

Modified at 2026-07-08 19:01:40

Get act-on-behalf access for a customer

Portfolio call analytics for a month