---
updatedAt: 2026-09-07T10:30:07.000Z
agentTools:
  projectIndex: https://docs.itispay.com/llms.txt
---

# List custody wallet hashes

Return custody wallet addresses and balances for the authenticated project. One entry is returned per cryptocurrency.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Cryptocurrency Invoice API",
    "version": "1.1.0",
    "description": "REST API for generating and managing cryptocurrency invoices with support for multiple transactions per invoice",
    "license": {
      "name": "MIT",
      "url": "https://opensource.org/licenses/MIT"
    },
    "contact": {
      "name": "API Support",
      "email": "api@itispay.com",
      "url": "https://itispay.com/support"
    }
  },
  "servers": [
    {
      "url": "https://api.itispay.com",
      "description": "Production server"
    }
  ],
  "components": {
    "securitySchemes": {
      "ApiKeyAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "Api-key",
        "description": "To obtain an API key, you must register on https://itispay.com. After successful registration, you can access your API key through your account dashboard. Provide your API key in the Api-key header as: Api-key: YOUR_API_KEY"
      }
    },
    "schemas": {
      "ErrorDetail": {
        "type": "object",
        "properties": {
          "field": {
            "type": "string",
            "description": "Name of the field that has the error"
          },
          "message": {
            "type": "string",
            "description": "Specific error message for the field"
          }
        }
      },
      "ErrorContent": {
        "type": "object",
        "properties": {
          "code": {
            "type": "integer",
            "description": "HTTP status code"
          },
          "message": {
            "type": "string",
            "description": "Main error message"
          },
          "details": {
            "type": "array",
            "description": "Array of field-specific error details (optional, empty for non-validation errors)",
            "items": {
              "$ref": "#/components/schemas/ErrorDetail"
            }
          }
        }
      },
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "$ref": "#/components/schemas/ErrorContent"
          }
        }
      },
      "WalletHash": {
        "type": "object",
        "properties": {
          "currency": {
            "type": "string",
            "example": "BTC"
          },
          "address": {
            "type": "string",
            "description": "Custody wallet hash/address.",
            "example": "bc1p6t3hy0xyhxk5rzjdhshrpwpyxp5f4vm4nx30wglatm636ca2r0psdk7jsy"
          },
          "balance": {
            "type": "string",
            "example": "0.00000000"
          },
          "fiat_currency": {
            "type": "string",
            "example": "USD"
          },
          "fiat_rate": {
            "type": "string",
            "example": "0.000012525379550313800000000"
          },
          "balance_fiat": {
            "type": "string",
            "example": "0.00"
          }
        }
      },
      "WalletHashesResponse": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/WalletHash"
            }
          }
        }
      }
    }
  },
  "security": [
    {
      "ApiKeyAuth": []
    }
  ],
  "tags": [
    {
      "name": "Crypto deposit/withdraw",
      "description": "Reusable cryptocurrency deposit addresses, custody wallet hashes, and crypto withdrawals."
    }
  ],
  "paths": {
    "/api/v1/wallets": {
      "get": {
        "summary": "List custody wallet hashes",
        "description": "Return custody wallet addresses and balances for the authenticated project. One entry is returned per cryptocurrency.",
        "operationId": "listWallets",
        "tags": [
          "Crypto deposit/withdraw"
        ],
        "responses": {
          "200": {
            "description": "Custody wallet hashes",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WalletHashesResponse"
                },
                "example": {
                  "items": [
                    {
                      "currency": "BTC",
                      "address": "bc1p6t3hy0xyhxk5rzjdhshrpwpyxp5f4vm4nx30wglatm636ca2r0psdk7jsy",
                      "balance": "0.00000000",
                      "fiat_currency": "USD",
                      "fiat_rate": "0.000012525379550313800000000",
                      "balance_fiat": "0.00"
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized - missing API key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Failed to fetch wallets",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented - wallets are not supported for this project",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    }
  }
}
```