Accounts

List Account Reserves

Changed on

Lists what the account's held balance is made of, one entry per currency: the total held, why each part is held, and the days it unlocks.

get/accounts/{account_id}/reserves

Request

  • Base URL: https://api.whop.com/api/v1
  • URL: https://api.whop.com/api/v1/accounts/{account_id}/reserves
  • Auth: HTTP bearer

Path parameters

account_idstring required

Account ID, prefixed biz_.

Headers

Api-Version-Datestring
Example:2026-10-15-1

Pins the request to a dated API version.

Response

empty when nothing is held

Example response

{
  "data": [
    {
      "amount": "125.5",
      "by_type": [
        {
          "amount": "100.0",
          "hold_period_days": 90,
          "percentage": 25,
          "type": "regular"
        }
      ],
      "currency": "usd",
      "unlocks_by_date": [
        {
          "amount": "100.0",
          "by_type": [
            {
              "amount": "100.0",
              "type": "regular"
            }
          ],
          "date": "2026-01-01"
        }
      ]
    }
  ]
}

Changes

  • c771dc00bca6Revision changes
    • info

      added the required property //// to the response with the status

  • f1020c3ecda4Revision changes
    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status