---
title: "Get Settlement Bank Accounts API Reference"
description: "List an agent's registered AePS settlement recipients with unsettled funds and remaining limit."
canonical: "https://eps.eko.in/docs/aeps-get-settlement-accounts"
---


> **Canonical URL:** https://eps.eko.in/docs/aeps-get-settlement-accounts
> This is a machine-readable Markdown version of the page for AI agents and LLMs. The primary (HTML) version lives at the canonical URL above.

# Get Settlement Bank Accounts API Reference

`GET https://staging.eko.in/ekoapi/v3/user/payment/aeps/settlement/accounts`

List an agent's registered AePS settlement recipients with unsettled funds and remaining limit.

Returns the agent's saved settlement bank accounts (each with a `recipient_id`), the total unsettled fund, and the remaining daily settlement limit.

> View product & pricing details: [AePS Cashout](https://eps.eko.in/products/aeps-api.md)

## Query parameters

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| initiator_id | string | yes | Registered mobile number of the API user (see Platform Credentials). e.g. 9962981729 |
| user_code | string | yes | User code of the retailer/agent the service is run for. e.g. 20810200 |

## Headers

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| developer_key | string | yes | Static API key issued to your account after KYC. |
| secret-key | string | yes | Dynamic per-request signature: base64(HMAC-SHA256(timestamp, base64(access_key))). |
| secret-key-timestamp | string | yes | Current time in milliseconds since UNIX epoch, used to compute secret-key. Must match server time. |
| content-type | string | yes | application/json e.g. application/json |

## Response

⭐ marks fields highlighted as verifiable.

| Field | Type | Description |
| --- | --- | --- |
| status | number | Primary success indicator (0 = success). |
| message | string | Human-readable response / error message. |
| response_status_id | number | Granular status id; see the shared error-codes table. |
| response_type_id | number | A unique id for every possible response shape (success or error) — useful for client logic branching and analytics. |
| data | object | API-specific response payload. |
| data.unsettled_fund ⭐ | string | Total unsettled AePS fund available to settle (INR). |
| data.remaining_limit | string | Remaining settlement limit for the day (INR). |
| data.fund_transfer_list ⭐ | array | Registered settlement recipients. |
| data.fund_transfer_list.recipient_id ⭐ | string | Settlement recipient identifier — pass to Initiate Settlement. |
| data.fund_transfer_list.name | string | Account holder name. |
| data.fund_transfer_list.account | string | Bank account number. |
| data.fund_transfer_list.ifsc | string | Bank branch IFSC. |

## Example response

```json
{
  "response_status_id": -1,
  "data": {
    "unsettled_fund": "6100.0",
    "remaining_limit": "190000",
    "fund_transfer_list": [
      {
        "name": "Gaurav Mallik",
        "ifsc": "PUNB0309300",
        "account": "9989834392752938",
        "recipient_id": "1828"
      },
      {
        "name": "Gaurav Mallik",
        "ifsc": "BKID0006701",
        "account": "987867867967969",
        "recipient_id": "1829"
      }
    ]
  },
  "response_type_id": 1321,
  "message": "List of fund transfer recipients",
  "status": 0
}
```