---
page_source: https://docs.juspay.io/paytm-gateway-configuration/docs/express-checkout/list-wallets
page_title: List Wallets
---

## API Version: default


# List Wallets



Wallets can be listed only in the context of a `Customer`. This API will return the list of wallets which may or may not be **linked** .

If a direct debit is enabled by the provider for your setup, you can activate the same for customers using the `authenticate` and `link` APIs.

> **Note**
> For linked wallets, the balance in the response may not be the current balance.`last\_refreshed` field represents the date & time when the balance was updated last. Use `refresh` wallet API to update the balance for individual wallets. This results in a network call to the wallet provider and hence the response might be slow. 

## Endpoints:
- Production: https://api.juspay.in/customers/{customer_id}/wallets

## Request Type: 
GET

## Authorization:

#### Basic Auth:
Consists of two parts.

* Username: API Key obtained from Juspay dashboard
* Password: Empty string
- Value:   <p>Example:- <br> Basic MUQ2QUxxxxxxxxxxxxU5QTIxQzNFNTQwNkFDMEZCOg==</p>
- Tags: Base64 Encoded Username:Password, Mandatory
## Headers:

#### version:
Refer to #Introduction for latest version
- Tags: string
## Sample Code Snippets:
### Sample Request:

#### Request Code Snippet:

```request
curl -X GET https://api.juspay.in/customers/guest_user/wallets \
-u your_api_key:
```

### Sample Response:

#### Response:
```json
{
  "object": "list",
  "list": [
    {
      "id": "wlt_q23xzki3pazgtezo",
      "object": "wallet_account",
      "wallet": "MOBIKWIK",
      "token": "tok_winysteev9eftrwcv6me",
      "current_balance": 250,
      "linked": true,
      "last_refreshed": "2016-08-02T08:07:52+0000"
    },
    {
      "id": "wlt_mu2xfwb4mr18flbs",
      "object": "wallet_account",
      "wallet": "FREECHARGE",
      "token": null,
      "current_balance": null,
      "linked": false,
      "last_refreshed": null
    }
  ],
  "count": 10,
  "offset": 0,
  "total": 100
}
```

#### Metadata:
```json
{
  "object": "list",
  "list": [
    {
      "id": "wlt_d10hncoc6xldk",
      "object": "wallet_account",
      "wallet": "PAYTM",
      "token": null,
      "current_balance": null,
      "linked": false,
      "last_refreshed": null,
      "metadata": {
        "mobile_number": "99999999"
      },
      "gateway_reference_id": null
    }
  ],
  "count": 1,
  "offset": 0,
  "total": 1
}
```

## API Responses:
### 200:

#### List Wallets:
- Value:
  - **Object**:
    - Tags: String
  - **List**:
    - Value:
      - **Id**:
        - Tags: String
      - **Object**:
        - Tags: String
      - **Wallet**:
        - Tags: String
      - **Token**:
        - Tags: String
      - **Current_balance**:
        - Tags: String
      - **Linked**:
        - Tags: Boolean
      - **Last_refreshed**:
        - Tags: String
    - Tags: Array of objects
  - **Count**:
    - Tags: Integer
  - **Offset**:
    - Tags: Integer
  - **Total**:
    - Tags: Integer
- Tags: JSON

#### Metadata:
- Value:
  - **Object**:
    - Tags: String
  - **List**:
    - Value:
      - **Id**:
        - Tags: String
      - **Object**:
        - Tags: String
      - **Wallet**:
        - Tags: String
      - **Token**:
        - Tags: String
      - **Current_balance**:
        - Tags: String
      - **Linked**:
        - Tags: Boolean
      - **Last_refreshed**:
        - Tags: String
      - **Metadata.mobile_number**:
        - Value:
        - Tags: string
      - **Gateway_reference_id**:
        - Tags: String
    - Tags: Array of objects
  - **Count**:
    - Tags: integer
  - **Offset**:
    - Tags: integer
  - **Total**:
    - Tags: integer
- Tags: JSON
### 400:

#### object:
- Description: {}
- Tags: Object