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

**userId** `string` *required*

The user to fetch investments for.

**investment\_types** `string[]`

Array of investment types to filter for. Valid investment types include:

* Equity
* SAFE
* Debt
* Fixed Interest

**investment\_categories** `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"

**currencies** `string[]`

Array of currencies to filter for. Supported currencies include:

* NGN
* USD
* KES

```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
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.