List virtual transactions

GET

https://api.eu-west-1.aworld.cloud/app/v1/virtual-transactions

Retrieves a list of virtual currency transactions for the authenticated user.
Virtual transactions track credits, debits, and other changes to virtual currency balances.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Responses

🟢200OK

application/json

Virtual transactions retrieved successfully

Body

🟠401Unauthorized

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.eu-west-1.aworld.cloud/app/v1/virtual-transactions?limit&nextToken' \
--header 'Authorization: Bearer <token>'

Response Example

{
    "items": [
        {
            "userId": "string",
            "virtualCurrencyId": "string",
            "virtualTransactionId": "string",
            "virtualTransactionGroupId": "string",
            "redemptionGroupId": "string",
            "redemptionMode": "AUTO",
            "state": "PENDING",
            "direction": "CREDIT",
            "initiatorType": "USER",
            "initiator": "string",
            "counterpartType": "USER",
            "counterpart": "string",
            "additionalData": {
                "property1": "string",
                "property2": "string"
            },
            "amount": 0,
            "expiresAt": "2019-08-24T14:15:22.123Z",
            "redeemedAt": "string",
            "createdAt": "2019-08-24T14:15:22.123Z",
            "updatedAt": "2019-08-24T14:15:22.123Z"
        }
    ],
    "nextToken": "eyJwayI6IndvcmtzcGFjZUlkI3pPR0JndVctQWoiLCJxdWl6SWQiOiItRktBdDZfbXM4M3RvSUZaLWVjeFQifQ=="
}

Modified at 2026-02-10 10:37:54

Get virtual balance by currency ID

Create virtual transaction