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

# List Deposits

> Retrieve all deposit records for your account

Returns a list of all payin deposits received into your wallets and virtual accounts.

```
GET https://api.yativo.com/api/v1/wallet/deposits
```

## Query parameters

<ParamField query="page" type="number">
  Page number for pagination (default: 1).
</ParamField>

<ParamField query="per_page" type="number">
  Records per page (default: 15).
</ParamField>

<ParamField query="gateway" type="string">
  Filter by payment gateway ID.
</ParamField>

<ParamField query="currency" type="string">
  Filter by currency code, e.g. `"PEN"`, `"BRL"`.
</ParamField>

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

<ParamField query="start_date" type="string">
  Filter by start date (`YYYY-MM-DD`).
</ParamField>

<ParamField query="end_date" type="string">
  Filter by end date (`YYYY-MM-DD`).
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET 'https://api.yativo.com/api/v1/wallet/deposits?page=1&per_page=15' \
    -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'
  ```

  ```javascript Node.js theme={null}
  const response = await fetch('https://api.yativo.com/api/v1/wallet/deposits', {
    headers: { 'Authorization': `Bearer ${token}` },
  });
  const data = await response.json();
  ```
</RequestExample>

<ResponseExample>
  ```json Success theme={null}
  {
    "status": "success",
    "status_code": 200,
    "message": "Request successful",
    "data": [
      {
        "id": "dep-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "gateway": 12,
        "deposit_currency": "PEN",
        "amount": 500.00,
        "receive_amount": 9.36,
        "currency_to": "USD",
        "status": "completed",
        "transaction_id": "txn-2026040201",
        "created_at": "2026-04-02T09:30:00.000000Z",
        "updated_at": "2026-04-02T09:32:00.000000Z"
      },
      {
        "id": "dep-b2c3d4e5-f6a7-8901-bcde-fg2345678901",
        "gateway": 15,
        "deposit_currency": "BRL",
        "amount": 1200.00,
        "receive_amount": 230.00,
        "currency_to": "USD",
        "status": "completed",
        "transaction_id": "txn-2026040202",
        "created_at": "2026-04-01T14:00:00.000000Z",
        "updated_at": "2026-04-01T14:05:00.000000Z"
      }
    ],
    "pagination": {
      "total": 28,
      "per_page": 15,
      "current_page": 1,
      "last_page": 2,
      "next_page_url": "https://api.yativo.com/api/v1/wallet/deposits?page=2",
      "prev_page_url": null
    }
  }
  ```
</ResponseExample>
