Reading User Transactions

Before You Start

Read the following guides before proceeding:

Activities represent all financial transactions in the user's account. Each activity tracks a specific transaction from initiation through completion, including deposits, withdrawals, card purchases, bank transfers, and crypto movements. Activities provide a complete audit trail with status updates, amounts, and involved parties.

Every activity has a type (determining the transaction category), direction (inbound/outbound/internal), and status (pending/completed/failed). Multi-step transactions include activity steps that show progression through each processing stage. Activity data is delivered via webhooks in real-time and can be queried on-demand through the activity feed endpoint.

Activity Query Flow (Simplified)

Detailed documentation available in Activity History.

sequenceDiagram
    participant User
    participant App as Your App
    participant BaaS as Wirex BaaS

    Note over User,BaaS: Query Activities
    User->>App: View history
    App->>BaaS: GET /api/v1/activity/feed
    BaaS-->>App: activities[]
    App-->>User: Transaction list

    Note over User,BaaS: Filter by Type
    User->>App: View card only
    App->>BaaS: GET /api/v1/activity/feed?types=CardTransaction
    BaaS-->>App: activities[]
    App-->>User: Filtered list

    Note over User,BaaS: Filter by Subject
    User->>App: View card history
    App->>BaaS: GET /api/v1/activity/feed?subject={card_id}
    BaaS-->>App: activities[]
    App-->>User: Card activities