# Unified activity feed across fund accounts

> 🔒 **Private label — [contact sales](mailto:sales@boyahq.com).** Requires a private-label entitlement on your API client.

Unified activity feed across fund accounts

Endpoint: GET /investments/portfolio/activity
Version: 2.0.0
Security: oauth2ClientCredentials

## Query parameters:

  - `range` (string)

  - `type` (string)

## Header parameters:

  - `Idempotency-Key` (string)
    Required on write endpoints (POST). UUID per submission. Middleware dedupes for 24h.

  - `org_wallet_ref` (string)

  - `business_id` (string, required)

## Response 200 fields (application/json):

  - `range` (string, required)
    Enum: "7D", "30D", "ALL"

  - `type` (string, required)
    Enum: "ALL", "INVESTMENT", "INTEREST", "WITHDRAWAL"

  - `docs` (array, required)

  - `docs.id` (string, required)
    Example: txn_01HXYZ...

  - `docs.occurred_at` (string, required)
    ISO 8601 timestamp
    Example: 2024-08-12T09:14:00.000Z

  - `docs.type` (string, required)
    Enum: "ALL", "MMF-INVESTMENT", "MMF-INTEREST", "MMF-WITHDRAWAL", "MMF-UNKNOWN"

  - `docs.amount` (number, required)
    Signed amount: credit positive, debit negative
    Example: 50000

  - `docs.currency` (string, required)
    Example: KES

  - `docs.status` (string)
    Example: SUCCESS

  - `docs.description` (string)
    Example: Britam KES MMF interest

  - `docs.reference` (string)
    Internal Boya reference
    Example: MMF-D4B58C018D

  - `docs.external_reference` (string)
    Custodian (Britam) provider reference
    Example: 132210551

  - `docs.credit` (number)
    Raw credit amount from the ledger
    Example: 42.28

  - `docs.debit` (number)
    Raw debit amount from the ledger
    Example: 0

  - `total` (number, required)
    Example: 42