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

# List USD virtual account deposits

> List payments received into USD virtual accounts

## Overview

Retrieve payments received into USD virtual accounts. Use this endpoint when a customer pays into USD bank details created with `/v1/virtual-accounts`.

<Info>
  Use [List deposits](/api-reference/deposits/list-deposits) for NGN and crypto deposits received through funding accounts.
</Info>

## Authentication

<ParamField header="X-Api-Key" type="string" required>
  Your merchant API key
</ParamField>

## Query Parameters

<ParamField query="customer_id" type="string">
  Filter by customer ID (UUID).
</ParamField>

<ParamField query="virtual_account_id" type="string">
  Filter by USD virtual account ID (UUID).
</ParamField>

<ParamField query="status" type="string">
  Filter by USD account deposit status.

  **Allowed values:** `PENDING` | `COMPLETED` | `FLAGGED` | `FAILED`
</ParamField>

<ParamField query="from" type="string">
  Filter deposits created from this time (RFC 3339, inclusive).
</ParamField>

<ParamField query="to" type="string">
  Filter deposits created before this time (RFC 3339, exclusive).
</ParamField>

<ParamField query="limit" type="integer">
  Results per page.

  **Default:** `50` | **Max:** `200`
</ParamField>

<ParamField query="page" type="integer">
  Page number to retrieve.

  **Default:** `1`
</ParamField>

## Request Examples

<CodeGroup>
  ```bash List USD Virtual Account Deposits theme={null}
  curl --request GET \
    --url 'https://api.daya.co/v1/virtual-account-deposits' \
    --header 'X-Api-Key: YOUR_API_KEY'
  ```

  ```bash By Virtual Account theme={null}
  curl --request GET \
    --url 'https://api.daya.co/v1/virtual-account-deposits?virtual_account_id=550e8400-e29b-41d4-a716-446655440000' \
    --header 'X-Api-Key: YOUR_API_KEY'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://api.daya.co/v1/virtual-account-deposits?status=COMPLETED&limit=50&page=1',
    {
      headers: {
        'X-Api-Key': 'YOUR_API_KEY'
      }
    }
  );
  const data = await response.json();
  ```
</CodeGroup>

## Response

<ResponseField name="data" type="array" required>
  Array of USD account deposit objects.

  <Expandable title="deposit properties">
    <ResponseField name="id" type="string">
      Unique deposit identifier (UUID).
    </ResponseField>

    <ResponseField name="type" type="string">
      Always `USD_DEPOSIT`.
    </ResponseField>

    <ResponseField name="va_deposit_id" type="string">
      USD account deposit ID.
    </ResponseField>

    <ResponseField name="customer_id" type="string">
      Associated customer ID.
    </ResponseField>

    <ResponseField name="amount" type="string">
      Amount received in USD.
    </ResponseField>

    <ResponseField name="currency" type="string">
      Always `USD`.
    </ResponseField>

    <ResponseField name="settled_amount" type="string">
      Amount credited after fees, when settled.
    </ResponseField>

    <ResponseField name="settled_currency" type="string">
      Settlement currency, usually `USD`.
    </ResponseField>

    <ResponseField name="payment_rail" type="string">
      Payment rail used, such as `ach` or `wire`.
    </ResponseField>

    <ResponseField name="sender" type="object">
      Sender information when available.
    </ResponseField>

    <ResponseField name="status" type="string">
      Public status: `PENDING`, `COMPLETED`, `FLAGGED`, or `FAILED`.
    </ResponseField>

    <ResponseField name="settlement_status" type="string">
      Settlement progress.
    </ResponseField>

    <ResponseField name="fees" type="object">
      Fees applied to the deposit.
    </ResponseField>

    <ResponseField name="developer_fee" type="object">
      Merchant developer fee kept from this USD deposit, when configured. This is separate from Daya fees.

      <Expandable title="developer_fee properties">
        <ResponseField name="developer_fee.percentage" type="string">
          Configured percentage as a decimal string.
        </ResponseField>

        <ResponseField name="developer_fee.amount" type="string">
          Amount kept by your merchant account after settlement.
        </ResponseField>

        <ResponseField name="developer_fee.currency" type="string">
          Currency of the developer fee amount.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="customer_amount" type="object">
      Amount left for the customer after Daya fees and the developer fee, when available.

      <Expandable title="customer_amount properties">
        <ResponseField name="customer_amount.amount" type="string">
          Amount left for the customer.
        </ResponseField>

        <ResponseField name="customer_amount.currency" type="string">
          Currency of the customer amount.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="created_at" type="string">
      Time the payment was received.
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      Last status update time.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="page" type="integer" required>
  Current page number.
</ResponseField>

<ResponseField name="limit" type="integer" required>
  Results per page.
</ResponseField>

<ResponseField name="total" type="integer" required>
  Total number of deposits matching filters.
</ResponseField>

<ResponseField name="total_pages" type="integer" required>
  Total number of pages available.
</ResponseField>

### Success Response

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "data": [
      {
        "id": "9c4e8400-e29b-41d4-a716-446655440000",
        "type": "USD_DEPOSIT",
        "va_deposit_id": "9c4e8400-e29b-41d4-a716-446655440000",
        "customer_id": "650e8400-e29b-41d4-a716-446655440000",
        "amount": "100.00",
        "currency": "USD",
        "settled_amount": "99.50",
        "settled_currency": "USD",
        "payment_rail": "ach",
        "sender": {
          "name": "Jane Doe",
          "account_number": "****1234",
          "bank_name": "Chase"
        },
        "status": "COMPLETED",
        "settlement_status": "COMPLETED",
        "fees": {
          "deposit_fee": { "amount": "0.50", "currency": "USD" },
          "total_fee_usd": "0.50"
        },
        "developer_fee": {
          "percentage": "1.5",
          "amount": "1.49",
          "currency": "USD"
        },
        "customer_amount": {
          "amount": "98.01",
          "currency": "USD"
        },
        "created_at": "2026-01-14T17:00:00Z",
        "updated_at": "2026-01-14T17:01:30Z"
      }
    ],
    "page": 1,
    "limit": 50,
    "total": 1,
    "total_pages": 1
  }
  ```
</ResponseExample>

## Next Steps

<CardGroup cols={2}>
  <Card title="Get USD Virtual Account Deposit" icon="magnifying-glass" href="/api-reference/virtual-account-deposits/get-usd-account-deposit">
    Get a specific USD virtual account deposit by ID
  </Card>

  <Card title="USD Virtual Accounts" icon="building-columns" href="/concepts/virtual-accounts">
    Learn how USD virtual accounts work
  </Card>
</CardGroup>