# 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 messages value.

# Response

{
    "currency": "EUR",
    "totalDeposits": 0,
    "totalConsumed": 1689.51,
    "creditRemaining": -1689.51,
    "orderSummary": {
        "messages": {
            "count": 49000,
            "totalAmount": 1686.84
        }
    }
}

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.messages.totalAmount`	Sum of messages amounts.

Amounts in orderSummary.messages are estimations. For a per-order breakdown see GET /v1/account/messages.

# 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/messages

Returns a paginated list of messages 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": [
        {
            "message_uuid": "392b08a2-...",
            "recipient": "40712345678",
            "message": "<message>",
            "amount": 0.03,
            "currency": "EUR",
            "external_status": "delivered",
            "created_at": "2026-03-29T17:32:20.000Z"
        }
    ],
    "pagination": {
        "page": 1,
        "limit": 20,
        "total": 101595,
        "total_pages": 5080
    }
}