# Account

These endpoints provide read-only access to your account's financial summary and transaction history. All requests must include your API key in the X-Authorization header.

# GET /v1/account

Returns a financial summary of your account: total funds deposited, total consumed, remaining credit, and a breakdown of recharges value.

# Response

{
    "currency": "RON",
    "totalDeposits": 10000,
    "totalConsumed": 4400.72,
    "creditRemaining": 5599.28,
    "orderSummary": {
        "recharges": {
            "count": 118,
            "totalAmountNet": 3517.45,
            "totalAmountGross": 4256.11,
            "totalFastRechargeFeeNet": 119.48,
            "totalFastRechargeFeeGross": 144.57,
            "totalVat": 763.76,
            "totalDeducted": 4400.69
        }
    }
}

Field	Description
`currency`	Your account currency.
`totalDeposits`	Sum of all funds deposited into your account, converted to your account currency.
`creditRemaining`	Current balance.
`totalConsumed`	Funds consumed (`totalDeposits − creditRemaining`).
`orderSummary.recharges.totalAmountNet`	Sum of recharge amounts before VAT.
`orderSummary.recharges.totalAmountGross`	Sum of recharge amounts including VAT.
`orderSummary.recharges.totalFastRechargeFeeNet`	Sum of fast recharge fees before VAT.
`orderSummary.recharges.totalFastRechargeFeeGross`	Sum of fast recharge fees including VAT.
`orderSummary.recharges.totalVat`	Total VAT across all recharges and fees.
`orderSummary.recharges.totalDeducted`	Total amount deducted from your balance for recharges (gross amount + gross fee).

Amounts in orderSummary.recharges are estimations derived from rates stored at the time each order was placed. For a per-order breakdown see GET /v1/account/recharges.

# GET /v1/account/balance

Returns the current remaining credit balance.

# Response

{
    "balance": 1179.45,
    "currency": "EUR"
}

# GET /v1/account/deposits

Returns a paginated list of deposits made to your account.

# Query Parameters

Parameter	Default	Max	Description
`page`	`1`	—	Page number.
`limit`	`20`	`100`	Number of results per page.

# Response

{
    "data": [
        {
            "amount": 5000,
            "currency": "RON",
            "created_at": "2026-03-16T06:55:13.000Z"
        }
    ],
    "pagination": {
        "page": 1,
        "limit": 20,
        "total": 2,
        "total_pages": 1
    }
}

# GET /v1/account/recharges

Returns a paginated list of recharge orders placed by your account, ordered by most recent first.

# Query Parameters

Parameter	Default	Max	Description
`page`	`1`	—	Page number.
`limit`	`20`	`100`	Number of results per page.

# Response

{
    "data": [
        {
            "recharge_uuid": "98a1853c-...",
            "number": "40712345678",
            "network": "vodafone",
            "amount": 6,
            "currency": "EUR",
            "recharge_status": "SUCCESS",
            "fast_recharge": true,
            "created_at": "2026-03-29T12:40:53.000Z"
        }
    ],
    "pagination": {
        "page": 1,
        "limit": 20,
        "total": 126,
        "total_pages": 7
    }
}