> ## Documentation Index > Fetch the complete documentation index at: https://docs.spherepay.co/llms.txt > Use this file to discover all available pages before exploring further. # List All Offloader Wallets for Your Account > List all offloader wallets Retrieve a paginated list of all Offloader Wallets in your account. Use the `customerId` query parameter to narrow results to a single customer. This endpoint is useful for auditing wallet configurations, reconciling on-chain addresses to bank account destinations, or building a customer-facing wallet management interface. ## OpenAPI ````yaml openapi/spherepay.yaml GET /v2/offloader-wallet openapi: 3.0.0 info: contact: {} description: The Sphere REST API for payments, transfers, and accounts. title: Sphere API version: '2' servers: - description: Production url: https://api.spherepay.co security: - bearer: [] tags: [] paths: /v2/offloader-wallet: get: summary: List offloader wallets description: List all offloader wallets operationId: getV2OffloaderWallet parameters: - description: 'Page number of the list (default: 1)' in: query name: page required: true schema: default: '1' example: 1 type: string - description: 'Number of items per page (default: 10)' in: query name: limit required: true schema: default: '10' example: 10 type: string - description: >- Filter offloader wallets by customer ID. Only wallets belonging to this customer will be returned. in: query name: customerId required: false schema: example: customer_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6 type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/ListOffloaderWalletsResponseDto' description: '' '400': content: application/json: examples: Bad Request: summary: Bad Request value: code: address/invalid correlationId: 28c61e885c6e5eaa78c1a2183a9b883c detail: Invalid request parameters status: 400 schema: $ref: '#/components/schemas/ProblemDetailsDto' description: Bad Request '404': content: application/json: examples: Not Found: summary: Not Found value: code: resource/not-found correlationId: 28c61e885c6e5eaa78c1a2183a9b883c detail: Resource not found status: 404 schema: $ref: '#/components/schemas/ProblemDetailsDto' description: Not Found '422': content: application/json: examples: Validation Error: summary: Validation Error value: code: validation/failed correlationId: 28c61e885c6e5eaa78c1a2183a9b883c detail: Validation failed errors: - detail: Invalid email format pointer: /email - detail: Name is required pointer: /name status: 422 schema: $ref: '#/components/schemas/ProblemDetailsDto' description: Unprocessable Entity - Validation Error components: schemas: ListOffloaderWalletsResponseDto: properties: data: description: Array of offloader wallet objects. items: description: >- See the [Offloader Wallets guide](/concepts/automation/offloader-wallets). properties: address: description: >- The on-chain deposit address for the offloader wallet. Send crypto to this address to trigger automatic conversion. example: '0x4838B106FCe9647Bdf1E7877BF73cE8B0BAD5f97' type: string created: description: Timestamp when the offloader wallet was created (ISO 8601). example: '2024-06-15T10:30:00.000Z' type: string currency: description: >- The crypto currency the offloader wallet accepts for deposits. See [Supported Rails & Currencies](/concepts/transfers/supported-rails). enum: - usdc - usdt - eurc example: usdc type: string customerId: description: The customer who owns the offloader wallet. example: customer_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6 type: string destination: description: >- The bank account destination where converted funds are sent. See [Bank Accounts guide](/concepts/transfers/bank-accounts). example: achReference: REF123 bankAccountId: bankAccount_6221e8d4299f4a889bd882255e92f581 currency: usd network: ach oneOf: - properties: achReference: description: >- Reference sent to the receiving institution with ACH transfers, 1-10 characters. example: REF123 maxLength: 10 minLength: 1 type: string bankAccountId: description: >- The ID of the bank account that converted funds will be sent to. See [Bank Accounts guide](/concepts/transfers/bank-accounts). example: bankAccount_6221e8d4299f4a889bd882255e92f581 type: string currency: description: The fiat currency the crypto will be converted into. enum: - usd example: usd type: string network: description: >- The banking network used to deliver funds to the destination account. See [Supported Rails & Currencies](/concepts/transfers/supported-rails). enum: - ach example: ach type: string required: - bankAccountId - currency - network title: ACH type: object - properties: bankAccountId: description: >- The ID of the bank account that converted funds will be sent to. See [Bank Accounts guide](/concepts/transfers/bank-accounts). example: bankAccount_6221e8d4299f4a889bd882255e92f581 type: string currency: description: The fiat currency the crypto will be converted into. enum: - usd example: usd type: string network: description: >- The banking network used to deliver funds to the destination account. See [Supported Rails & Currencies](/concepts/transfers/supported-rails). enum: - wire example: wire type: string wireMessage: description: >- Message sent to the receiving institution with wire transfers, 1-105 characters. example: 'Invoice #1024' maxLength: 105 minLength: 1 type: string required: - bankAccountId - currency - network title: Wire type: object - properties: bankAccountId: description: >- The ID of the bank account that converted funds will be sent to. See [Bank Accounts guide](/concepts/transfers/bank-accounts). example: bankAccount_6221e8d4299f4a889bd882255e92f581 type: string currency: description: The fiat currency the crypto will be converted into. enum: - eur example: eur type: string network: description: >- The banking network used to deliver funds to the destination account. See [Supported Rails & Currencies](/concepts/transfers/supported-rails). enum: - sepa example: sepa type: string sepaReference: description: >- Reference sent to the receiving institution with SEPA transfers, 6-140 characters. example: INV-2024-001 maxLength: 140 minLength: 6 type: string required: - bankAccountId - currency - network title: SEPA type: object fees: description: >- Fee configuration for the offloader wallet, including integrator and platform fees. example: integratorFee: bpsRate: '100' currency: usdc platformFee: bpsRate: '30' currency: usdc properties: integratorFee: properties: bpsRate: description: Integrator fee rate in basis points (1 bps = 0.01%). example: '100' type: string currency: description: >- The currency the integrator fee is denominated in (matches the wallet deposit currency). enum: - usdc - usdt - eurc example: usdc type: string required: - bpsRate - currency type: object platformFee: properties: bpsRate: description: Platform fee rate in basis points (1 bps = 0.01%). example: '30' type: string currency: description: >- The currency the platform fee is denominated in (matches the wallet deposit currency). enum: - usdc - usdt - eurc example: usdc type: string required: - bpsRate - currency type: object required: - integratorFee - platformFee type: object id: description: Unique identifier for the offloader wallet. example: wallet_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6 type: string network: description: >- The blockchain network the offloader wallet is on. See [Supported Rails & Currencies](/concepts/transfers/supported-rails). enum: - sol - ethereum - arbitrum - polygon - base - avalanche - tron example: ethereum type: string returnAddress: description: >- Crypto address where funds are returned on failed transactions. Must be valid for the wallet network. Null if not configured. example: '0x4838B106FCe9647Bdf1E7877BF73cE8B0BAD5f97' type: string status: description: >- Lifecycle status of the offloader wallet. `active` accepts deposits and settles; `deactivated` no longer settles. enum: - active - deactivated example: active type: string x-enumNames: - ACTIVE - DEACTIVATED updated: description: >- Timestamp when the offloader wallet was last updated (ISO 8601). example: '2024-06-15T12:00:00.000Z' type: string required: - id - customerId - address - currency - network - status - destination - fees - created - updated type: object type: array pagination: properties: hasNext: description: Whether there is a next page example: false type: boolean hasPrevious: description: Whether there is a previous page example: false type: boolean limit: description: Number of items per page example: 10 exclusiveMaximum: false exclusiveMinimum: false maximum: 100 minimum: 1 type: number page: description: Current page number example: 1 type: number total: description: Total number of items example: 1 type: number totalPages: description: Total number of pages example: 1 type: number required: - page - limit - total - totalPages - hasNext - hasPrevious type: object required: - data - pagination type: object ProblemDetailsDto: properties: code: type: string correlationId: type: string detail: type: string errors: items: properties: detail: type: string header: type: string parameter: type: string pointer: type: string required: - detail type: object type: array status: type: integer title: type: string required: - status - detail type: object securitySchemes: bearer: bearerFormat: JWT scheme: bearer type: http ````