> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kemycard.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Deposits

> Lists the deposits received on the wallets of your customers, most recent first. Each deposit gives
the amount sent, the fee and the net amount credited to your collection account.




## OpenAPI

````yaml GET /wallets/deposits
openapi: 3.1.0
info:
  title: KemyCard API
  version: '1.0'
  description: >
    KemyCard API allows you to issue virtual and physical cards, manage KYC/POA
    verification,

    create crypto wallets, virtual bank accounts, and purchase gift cards.
  contact:
    name: KemyCard API Support
    email: hi@kemycard.com
servers:
  - url: https://api.kemycard.com/v1
    description: Production
security:
  - BearerAuth: []
tags:
  - name: Customers
    description: Manage your customers
  - name: Card Products
    description: Browse the card product catalog
  - name: Cards
    description: Issue and manage cards
  - name: KYC
    description: Identity verification
  - name: POA
    description: Proof of address verification
  - name: Wallets
    description: Crypto wallets
  - name: Virtual Accounts
    description: Virtual bank accounts
  - name: Gift Cards
    description: Gift card catalog and purchases
  - name: Balance
    description: Operational balances and transaction history
  - name: Webhooks
    description: Webhook endpoints and delivery management
paths:
  /wallets/deposits:
    get:
      tags:
        - Wallets
      summary: List deposits
      description: >
        Lists the deposits received on the wallets of your customers, most
        recent first. Each deposit gives

        the amount sent, the fee and the net amount credited to your collection
        account.
      operationId: listWalletDeposits
      parameters:
        - $ref: '#/components/parameters/page'
        - $ref: '#/components/parameters/limit'
        - name: customer_code
          in: query
          description: Only return the deposits of this customer
          schema:
            type: string
            format: uuid
        - name: wallet_code
          in: query
          description: Only return the deposits received on this wallet
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Deposit list
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/WalletDeposit'
                  meta:
                    $ref: '#/components/schemas/Meta'
                  pagination:
                    $ref: '#/components/schemas/Pagination'
        '404':
          $ref: '#/components/responses/NotFound'
components:
  parameters:
    page:
      name: page
      in: query
      schema:
        type: integer
        default: 1
        minimum: 1
      description: Page number
    limit:
      name: limit
      in: query
      schema:
        type: integer
        default: 20
        minimum: 1
        maximum: 100
      description: Items per page (max 100)
  schemas:
    WalletDeposit:
      type: object
      properties:
        code:
          type: string
          description: Deposit code
        wallet_code:
          type: string
          format: uuid
        wallet_reference:
          type: string
          nullable: true
          description: >-
            The `reference` of the wallet that received the deposit, if you gave
            it one
        customer_code:
          type: string
          format: uuid
          nullable: true
          description: '`null` when the funds were sent directly to your collection address'
        external_reference:
          type: string
          nullable: true
        blockchain:
          type: string
          enum:
            - solana
            - base
            - ethereum
            - tron
        currency:
          type: string
          enum:
            - USDC
            - USDT
        amount:
          type: number
          description: Amount sent by your customer
          example: 100
        fee:
          type: number
          description: Deposit fee, taken from the amount
          example: 1.5
        net_amount:
          type: number
          description: Amount credited to your collection account
          example: 98.5
        tx_id:
          type: string
          description: Blockchain transaction
        from_address:
          type: string
          description: Address the funds were sent from
        received_at:
          type: string
          format: date-time
    Meta:
      type: object
      properties:
        request_id:
          type: string
          example: a4f8e2c1b3d97056
        mode:
          type: string
          enum:
            - test
            - live
          example: test
        timestamp:
          type: string
          format: date-time
    Pagination:
      type: object
      properties:
        page:
          type: integer
          example: 1
        limit:
          type: integer
          example: 20
        total:
          type: integer
          example: 42
        pages:
          type: integer
          example: 3
    ErrorResponse:
      type: object
      properties:
        success:
          type: boolean
          example: false
        error:
          type: object
          properties:
            code:
              type: string
              example: VALIDATION_ERROR
            message:
              type: string
              example: Missing required fields.
            details:
              type: object
              nullable: true
        meta:
          $ref: '#/components/schemas/Meta'
  responses:
    NotFound:
      description: Resource not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            success: false
            error:
              code: RESOURCE_NOT_FOUND
              message: Resource not found.
              details: null
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: API key (sk_test_... or sk_live_...)

````

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