---
title: "Create VA Alias (Bulk)"
method: POST
path: "/collection/vaAlias/createBulk"
tags: ["VA Code & Alias"]
---

# Create VA Alias (Bulk)

`POST /collection/vaAlias/createBulk`

## Request

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

Creates up to 30 Virtual accounts in a single call.

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

| Condition | Status Description |
|---|---|
| Missing range | Both va_range_start and va_range_end are required |
| Non-numeric range | va_range_start and va_range_end must be numeric values |
| Invalid range order | va_range_end must be greater than va_range_start |
| aliasList not an array | Invalid JSON format. Expected an array of alias objects |
| aliasList empty | Empty array provided. At least one alias object is required |
| Max limit exceeded | Array limit exceeded, only 30 VA Alias are allowed |
| Range not enough | Range not enough. Range size = X, alias count = Y |
| Invalid or missing va_code | va_code is mandatory and must be 5 characters long |
| VA Code does not exist | VA Code does not exist |
| Invalid va_name | va_name is mandatory and cannot exceed 100 characters |
| Invalid email format | va_email must be a valid email address |
| Invalid mobile number | va_mobile must be a valid 10-digit mobile number |
| Invalid remitter format | va_allowed_remitter must be a JSON array |
| Invalid remitter account number | Each remitter must have a valid account_number (5–24 digits) |
| Invalid remitter IFSC | Each remitter must have a valid IFSC code |
| Invalid numeric limit | <limit_field> must be a valid numeric value |
| Min amount greater than max | va_min_amount_limit cannot be greater than va_max_amount_limit |
| Invalid activation datetime | va_activation_dt is mandatory and must be a valid datetime |
| Invalid deactivation datetime | va_deactivation_dt must be a valid datetime if provided |
| Activation ≥ deactivation | va_activation_dt must be before va_deactivation_dt |
| Missing or invalid va_type | va_type is required |
| Invalid VA Type | va_type must be "DYNAMIC" or "STATIC" |
| Alias already exists | VA Alias already exists |
| Internal server error | Internal Server Error |

## Request body

- CreateVAAliasBulkRequest
  - `va_range_start` string: Numeric alias range reserved for this batch. Required together with va_range_end.
  - `va_range_end` string: End of the numeric alias range.
  - `aliasList` BulkAliasItem[], required: Array of alias objects, up to 30 per request.
    - `va_code` string, required: Parent VA Code (5 chars) for this alias.
    - `va_name` string: Alias holder name.
    - `va_email` string: Alias holder email.
    - `va_mobile` string: Alias holder mobile.
    - `va_type` 'STATIC' | 'DYNAMIC', required: STATIC or DYNAMIC.
    - `va_activation_dt` string: Activation datetime.
    - `va_min_amount_limit` string: Minimum credit amount (decimal string in this endpoint's example).
    - `va_max_amount_limit` string: Maximum credit amount (decimal string in this endpoint's example).
    - `va_allowed_remitter` VAAllowedRemitter[]: Array of allowed remitters.
      - `account_number` string: Remitter's bank account number (5–24 digits).
      - `account_ifsc` string: Remitter's bank IFSC code.

## Response `200`

Success or failure — see statusCode in the body.

- union
  - CreateVAAliasBulkResponse
    - `statusCode` integer
    - `statusDesc` string
    - `results` BulkAliasResult[]: One result entry per aliasList item.
      - `index` integer: Index of this item within the submitted aliasList.
      - `statusCode` integer
      - `statusDesc` string
      - `alias` string
      - `data` object
        - `id` integer
        - `va_alias` string
        - `type` 'STATIC' | 'DYNAMIC'
        - `is_active` integer
  - 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)