---
title: "List VA Aliases"
method: POST
path: "/collection/vaAlias/getAliasesList"
tags: ["VA Code & Alias"]
---

# List VA Aliases

`POST /collection/vaAlias/getAliasesList`

## Request

- Base URL: `https://jiof.trxns.in`
- URL: `https://jiof.trxns.in/collection/vaAlias/getAliasesList`
- Auth: HTTP bearer

Retrieves a paginated list of virtual accounts created by the merchant under a single VA code. Multiple filters can be applied (alias, UDF fields, remitter account, date ranges, limits, etc.).

**Failure conditions** (all return `statusCode: 900` with the description below):

| Condition | Status Description |
|---|---|
| Invalid VA Code | Invalid VA Code format |
| Invalid filter status | Invalid status: <value>. Allowed fields are: va_code, va_alias, va_range_start, va_range_end, va_remitter_account_no, va_remitter_ifsc, va_activation_dt, va_deactivation_dt, va_min_amount_limit, va_max_amount_limit, imps_limit, neft_limit, rtgs_limit, ift_limit, va_udf |
| No data found | No VA Aliases found for given filters. |
| Invalid numeric filter value | Invalid value for numeric field |
| Internal server error | Internal Server Error |

## Request body

- ListVAAliasesRequest
  - `va_code` string, required: Parent VA Code assigned at the time of onboarding.
  - `filters` VAAliasFilter[]: Filters to apply.
    - `status` string: Field name to filter on. Allowed values: va_code, va_alias, va_range_start, va_range_end, va_remitter_account_no, va_remitter_ifsc, va_activation_dt, va_deactivation_dt, va_min_amount_limit, va_max_amount_limit, imps_limit, neft_limit, rtgs_limit, ift_limit, va_udf.
    - `search` string: Value to search/filter for.
  - `page` integer: Page number.
  - `limit` integer: Page size.

## Response `200`

Success or failure — see statusCode in the body.

- union
  - ListVAAliasesResponse
    - `statusCode` integer
    - `statusDesc` string
    - `totalRecords` integer
    - `currentPage` integer
    - `totalPages` integer
    - `pageSize` integer
    - `data` VAAliasListItem[]: Virtual account alias records.
      - `id` integer
      - `type` 'STATIC' | 'DYNAMIC'
      - `va_name` string
      - `va_alias` string
      - `va_code` string
      - `is_active` integer
      - `bene_acc_no` string
  - VAFailureResponse
    - `statusCode` integer: Application-level status code. 900 indicates failure; the specific reason is in statusDesc.
    - `statusDesc` string: Human-readable description of the failure.

---

[API](https://skmtc.dev/jiopay/apis/virtual-accounts.md) - [All operations](https://skmtc.dev/jiopay/apis/virtual-accounts/llms.txt) - [OpenAPI document](https://skmtc.dev/jiopay/apis/virtual-accounts/revisions/069638c81b20?raw)