> ## Documentation Index
> Fetch the complete documentation index at: https://getequity.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Get User Investments

> Retrieves the investments that belong to a user.

<ParamField path="userId" type="string" required>
  The user to fetch investments for.
</ParamField>

<ParamField body="investment_types" type="string[]">
  Array of investment types to filter for. Valid investment types include:

  * Equity
  * SAFE
  * Debt
  * Fixed Interest
</ParamField>

<ParamField body="investment_categories" type="string[]">
  Array of investment categories to filter for. Valid investment categories include:
  "ETF" | "Bond" | "Commercial Paper" | "Debt Note" | "Real Estate" | "Private Business" | "Startup" | "Commodities" | "Fund" | "Art" | "Music" | "Movie" | "Charity"
</ParamField>

<ParamField body="currencies" type="string[]">
  Array of currencies to filter for. Supported currencies include:

  * NGN
  * USD
  * KES
</ParamField>

<ResponseExample>
  ```json theme={null}
  {
    "status": "success",
    "message": "User investments successfully returned",
    "data": [
      {
        "tokenId": "683ef69f70457700022e091b",
        "balance": 90.02,
        "lien": 9.98,
        "balance_value": 900200,
        "lien_value": 99800,
        "currency": "NGN",
        "investment_type": "Debt",
        "investment_category": "Debt Note",
        "name": "FCMB Debt Note",
        "symbol": "FDNE",
        "image": "https://res.cloudinary.com/djalafcj9/image/upload/v1748956437/getequity/profiles/user/vkxslmd8wwwicawnhb8d.png",
        "price": {
          "buy": 10000,
          "sell": 10000,
          "exchange": 10000
        },
        "raise_amount": 20000000,
        "interest": 23
      },
      {
        "tokenId": "682b2f367732900002613bfc",
        "balance": 93.44,
        "lien": 116.56,
        "balance_value": 934400,
        "lien_value": 1165600,
        "currency": "NGN",
        "investment_type": "Debt",
        "investment_category": "Commercial Paper",
        "name": "Ojaja Pan African LTD Series 2 Commercial Paper",
        "symbol": "OPAS2",
        "image": "https://res.cloudinary.com/djalafcj9/image/upload/v1747660006/getequity/profiles/user/awdrtenbvofwworewikc.png",
        "price": {
          "buy": 10000,
          "sell": 10000,
          "exchange": 10000
        },
        "raise_amount": 100000000,
        "interest": 29
      },
      {
        "tokenId": "6749cbc398b58800023c869d",
        "balance": 90,
        "lien": 10,
        "balance_value": 900000,
        "lien_value": 100000,
        "currency": "NGN",
        "investment_type": "Debt",
        "investment_category": "Debt Note",
        "name": "CredPal Debt Capital",
        "symbol": "CDCL",
        "image": "https://res.cloudinary.com/djalafcj9/image/upload/v1732889376/getequity/profiles/user/pneolukhhtxhozblth51.png",
        "price": {
          "buy": 10000,
          "sell": 10000,
          "exchange": 10000
        },
        "raise_amount": 100000000,
        "interest": 31
      },
      {
        "tokenId": "66d8fc02dde72d0002907df3",
        "balance": 1,
        "lien": 0,
        "balance_value": 10000,
        "lien_value": 0,
        "currency": "NGN",
        "investment_type": "Debt",
        "investment_category": "Commercial Paper",
        "name": "Desperado 25",
        "symbol": "D2A5",
        "image": "https://res.cloudinary.com/djalafcj9/image/upload/v1701207039/getequity/profiles/user/utqxfubmpmxtiktg68is.jpg",
        "price": {
          "buy": 10000,
          "sell": 10,
          "exchange": 10000
        },
        "raise_amount": 2000000,
        "interest": 31
      },
      {
        "tokenId": "66d8ef4eaaec01000251c6d7",
        "balance": 102.5,
        "lien": 297.5,
        "balance_value": 1025000,
        "lien_value": 2975000,
        "currency": "NGN",
        "investment_type": "Debt",
        "investment_category": "Commercial Paper",
        "name": "Desperado NGN",
        "symbol": "D2A3",
        "image": "https://res.cloudinary.com/djalafcj9/image/upload/v1701207039/getequity/profiles/user/utqxfubmpmxtiktg68is.jpg",
        "price": {
          "buy": 10000,
          "sell": 10000,
          "exchange": 10000
        },
        "raise_amount": 6000000,
        "interest": 30
      },
      {
        "tokenId": "65c2497a0d174a0002e11571",
        "balance": 1059.99,
        "lien": 0.01,
        "balance_value": 10599900,
        "lien_value": 100,
        "currency": "NGN",
        "investment_type": "Debt",
        "investment_category": "Commercial Paper",
        "name": "DAMO",
        "symbol": "DAMO",
        "image": "https://res.cloudinary.com/djalafcj9/image/upload/v1701207039/getequity/profiles/user/utqxfubmpmxtiktg68is.jpg",
        "price": {
          "buy": 10000,
          "sell": 10000,
          "exchange": 10000
        },
        "raise_amount": 10000000,
        "interest": 10
      }
    ]
  }
  ```
</ResponseExample>