---
updatedAt: 2025-09-29T20:18:16.000Z
agentTools:
  projectIndex: https://docs.bitwave.io/llms.txt
---

# /orgs/{orgId}/wallets

Returns all the wallets associated with your organization.

## Wallets

The */wallets/\{orgId}* endpoint will retrieve all the wallets associated with your organization.

# OpenAPI definition

```json
{
  "components": {
    "schemas": {
      "TSOAErrorResponse": {
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        },
        "required": [
          "code",
          "message"
        ],
        "type": "object",
        "additionalProperties": false
      },
      "BigNumber": {
        "type": "string"
      },
      "Coin": {
        "enum": [
          999999,
          1,
          5,
          10,
          20,
          30,
          703,
          704,
          731,
          800,
          1000,
          1001,
          1002,
          1003,
          1005,
          1012,
          1018,
          1022,
          1023,
          1025,
          1041,
          1044,
          1072,
          1087,
          1103,
          1107,
          1152,
          2435,
          2729,
          2882,
          3170,
          3315
        ],
        "type": "number"
      },
      "Record_string.string_": {
        "properties": {},
        "type": "object",
        "description": "Construct a type with a set of properties K of type T"
      },
      "RollupSelector": {
        "enum": [
          "revenue",
          "fees",
          "custom",
          "feeAndRevenue"
        ],
        "type": "string"
      },
      "RollupPeriod": {
        "enum": [
          "hour",
          "day",
          "month"
        ],
        "type": "string"
      },
      "RollupConfigDTO": {
        "properties": {
          "rollupSelector": {
            "$ref": "#/components/schemas/RollupSelector"
          },
          "rollupPeriod": {
            "$ref": "#/components/schemas/RollupPeriod"
          },
          "metadata": {
            "type": "string"
          },
          "accountCheck": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "seperateByAccount": {
            "type": "boolean"
          },
          "logSelector": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "seperateByLog": {
            "type": "boolean"
          },
          "rollupRevenue": {
            "type": "boolean"
          },
          "rollupTokenRevenue": {
            "type": "boolean"
          },
          "rollupFee": {
            "type": "boolean"
          },
          "rollupTokenRemittance": {
            "type": "boolean"
          },
          "rollupRemittance": {
            "type": "boolean"
          },
          "rollupAll": {
            "type": "boolean"
          }
        },
        "required": [
          "rollupSelector",
          "rollupPeriod"
        ],
        "type": "object",
        "additionalProperties": false
      },
      "LineDeltaDTO": {
        "properties": {
          "ticker": {
            "type": "string"
          },
          "succeededCheck": {
            "type": "boolean"
          },
          "isNegative": {
            "type": "boolean"
          },
          "localValue": {
            "$ref": "#/components/schemas/BigNumber"
          },
          "localFiatValue": {
            "$ref": "#/components/schemas/BigNumber"
          },
          "remoteValue": {
            "$ref": "#/components/schemas/BigNumber"
          },
          "remoteFiatValue": {
            "$ref": "#/components/schemas/BigNumber"
          },
          "warnings": {
            "items": {
              "type": "string"
            },
            "type": "array"
          }
        },
        "required": [
          "ticker",
          "succeededCheck",
          "isNegative"
        ],
        "type": "object",
        "additionalProperties": false
      },
      "BalanceCompareResultDTO": {
        "properties": {
          "controlSource": {
            "type": "string"
          },
          "controlTimestamp": {
            "type": "number",
            "format": "double"
          },
          "testSource": {
            "type": "string"
          },
          "testTimestamp": {
            "type": "number",
            "format": "double"
          },
          "totalFiatValue": {
            "$ref": "#/components/schemas/BigNumber"
          },
          "totalFiatDelta": {
            "$ref": "#/components/schemas/BigNumber"
          },
          "lineDeltas": {
            "items": {
              "$ref": "#/components/schemas/LineDeltaDTO"
            },
            "type": "array"
          },
          "succeedsThresholdCheck": {
            "type": "boolean"
          },
          "isNegative": {
            "type": "boolean"
          },
          "warnings": {
            "items": {
              "type": "string"
            },
            "type": "array"
          }
        },
        "required": [
          "controlSource",
          "controlTimestamp",
          "testSource",
          "testTimestamp",
          "totalFiatValue",
          "totalFiatDelta",
          "lineDeltas",
          "succeedsThresholdCheck",
          "isNegative",
          "warnings"
        ],
        "type": "object",
        "additionalProperties": false
      },
      "BalanceCheckResultDTO": {
        "properties": {
          "metaSuccess": {
            "type": "boolean"
          },
          "metaIsNegative": {
            "type": "boolean"
          },
          "serviceName": {
            "type": "string"
          },
          "results": {
            "items": {
              "$ref": "#/components/schemas/BalanceCompareResultDTO"
            },
            "type": "array"
          },
          "balanceId": {
            "type": "string"
          }
        },
        "required": [
          "metaSuccess",
          "metaIsNegative",
          "results",
          "balanceId"
        ],
        "type": "object",
        "additionalProperties": false
      },
      "WalletResponseDTO": {
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "addresses": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "orgId": {
            "type": "string"
          },
          "deleted": {
            "type": "boolean"
          },
          "remoteId": {
            "type": "string"
          },
          "disabled": {
            "type": "boolean"
          },
          "type": {
            "type": "number",
            "format": "double"
          },
          "groupId": {
            "type": "string"
          },
          "networkId": {
            "type": "string"
          },
          "connectionId": {
            "type": "string"
          },
          "rollupConfig": {
            "$ref": "#/components/schemas/RollupConfigDTO"
          },
          "metadata": {
            "$ref": "#/components/schemas/Record_string.string_"
          },
          "isSyncEnabled": {
            "type": "boolean"
          },
          "isBalanceMonitoringOnly": {
            "type": "boolean"
          },
          "isSyncEnabledSystem": {
            "type": "boolean"
          },
          "isSyncEnabledUser": {
            "type": "boolean"
          },
          "lastSuccessfulSyncSEC": {
            "type": "number",
            "format": "double"
          },
          "lastSuccessfulBalanceCheckSEC": {
            "type": "number",
            "format": "double"
          },
          "latestBalanceCheck": {
            "$ref": "#/components/schemas/BalanceCheckResultDTO"
          },
          "createdSEC": {
            "type": "number",
            "format": "double"
          },
          "categorizeTransactions": {
            "type": "boolean"
          },
          "accrualCadence": {
            "type": "string"
          },
          "syncToLatestInteraction": {
            "type": "boolean"
          },
          "generateAccruals": {
            "type": "boolean"
          },
          "categorizeAccruals": {
            "type": "boolean"
          },
          "defaultAccrualContact": {
            "type": "string"
          },
          "defaultAccrualCategory": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "name",
          "addresses",
          "orgId",
          "type",
          "isBalanceMonitoringOnly",
          "isSyncEnabledSystem",
          "isSyncEnabledUser"
        ],
        "type": "object",
        "additionalProperties": false
      },
      "WalletsResponse": {
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/WalletResponseDTO"
            },
            "type": "array"
          },
          "previousPage": {
            "type": "string"
          },
          "nextPage": {
            "type": "string"
          }
        },
        "required": [
          "items"
        ],
        "type": "object",
        "additionalProperties": false
      },
      "WalletIdTypes": {
        "enum": [
          "wallet",
          "enterprise",
          "exchange",
          "multisig-watch",
          "hardware-wallet",
          "user-wallet",
          "manual",
          "manual-blockchain-wallet",
          "connection",
          "account-based-blockchain-wallet",
          "group",
          "defi-wallet",
          "celo-wallet",
          "polygon-wallet",
          "avalanche-wallet",
          "bsc-wallet",
          "heco-wallet",
          "stx-wallet",
          "optimism-wallet"
        ],
        "type": "string"
      }
    }
  },
  "info": {
    "title": "api-svc",
    "version": "1.0.1",
    "contact": {}
  },
  "openapi": "3.0.0",
  "paths": {
    "/orgs/{orgId}/wallets": {
      "get": {
        "operationId": "GetWallets",
        "responses": {
          "200": {
            "description": "Ok",
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/WalletsResponse"
                    },
                    {
                      "$ref": "#/components/schemas/TSOAErrorResponse"
                    }
                  ]
                }
              }
            }
          }
        },
        "description": "Returns all the wallets associated with your organization.",
        "tags": [
          "Wallets"
        ],
        "security": [
          {
            "jwt": [
              "urn:orgs:$orgId:wallets:read"
            ]
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "orgId",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "walletIdType",
            "required": false,
            "schema": {
              "$ref": "#/components/schemas/WalletIdTypes"
            }
          },
          {
            "in": "query",
            "name": "pageLimit",
            "required": false,
            "schema": {
              "format": "double",
              "type": "number"
            }
          },
          {
            "in": "query",
            "name": "paginationToken",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "networkId",
            "required": false,
            "schema": {}
          },
          {
            "in": "query",
            "name": "connectionId",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "callWalletSvc",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          },
          {
            "in": "query",
            "name": "enabledCoin",
            "required": false,
            "schema": {
              "$ref": "#/components/schemas/Coin"
            }
          }
        ]
      }
    }
  },
  "servers": [
    {
      "url": "https://api.bitwave.io/"
    }
  ],
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  }
}
```