---
updatedAt: 2026-11-12T11:25:27.000Z
agentTools:
  projectIndex: https://docs.decentro.tech/llms.txt
---

# Bulk Validate Bank Account (Penniless /Penny Drop)

### API Endpoints

| Environment       | Endpoint                                                            |
| :---------------- | :------------------------------------------------------------------ |
| Staging / Sandbox | <https://in.staging.decentro.tech/v2/banking/bulk-validate-account> |
| Production        | <https://in.decentro.tech/v2/banking/bulk-validate-account>         |

> 🚧 Please export Postman Collection to test this API
>
> **Note:** This API cannot be tested here as file upload is not supported in this interface. Please export the Postman Collection and try the API there. Ensure that the file which you will be uploading is saved using UTF8 encoding.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "decentro-staging",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://in.staging.decentro.tech"
    }
  ],
  "security": [
    {}
  ],
  "paths": {
    "/v2/banking/bulk-validate-account": {
      "post": {
        "summary": "Bulk Validate Bank Account (Penniless /Penny Drop)",
        "description": "",
        "operationId": "payments_api-bulk-validate-bank-account",
        "parameters": [
          {
            "name": "client_id",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "client_secret",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "module_secret",
            "in": "header",
            "description": "Use the core banking module secret",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "provider_secret",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "content-type",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "default": "multipart/form-data"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "reference_id",
                  "file"
                ],
                "properties": {
                  "reference_id": {
                    "type": "string",
                    "description": "A specific unique ID assigned by you for this transaction. If not kept unique, transaction status extraction could behave erratically"
                  },
                  "file": {
                    "type": "string",
                    "description": "CSV input file to be passed",
                    "format": "binary"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Success": {
                    "value": "{\n    \"decentro_txn_id\": \"<decentro_txn_id>\",\n    \"status\": \"SUCCESS\",\n    \"response_code\": \"S00000\",\n    \"message\": \"Bulk validate successfully initiated.\",\n}"
                  }
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Duplicate Reference ID": {
                    "value": "{\n    \"decentroTxnId\": \"<decentro_txn_id>\",\n    \"status\": \"FAILURE\",\n    \"responseCode\": \"E00019\",\n    \"message\": \"Duplicate Request Reference ID\"\n}"
                  },
                  "Invalid file format": {
                    "value": "{\n    \"decentroTxnId\": \"<decentro_txn_id>\",\n    \"status\": \"FAILURE\",\n    \"responseCode\": \"E00019\",\n    \"message\": \"File doesn't have necessary columns. Required columns are reference_id, purpose_message, account_number, ifsc\"\n}"
                  }
                },
                "schema": {
                  "oneOf": [
                    {
                      "title": "Duplicate Reference ID",
                      "type": "object",
                      "properties": {
                        "decentroTxnId": {
                          "type": "string",
                          "example": "<decentro_txn_id>"
                        },
                        "status": {
                          "type": "string",
                          "example": "FAILURE"
                        },
                        "responseCode": {
                          "type": "string",
                          "example": "E00019"
                        },
                        "message": {
                          "type": "string",
                          "example": "Duplicate Request Reference ID"
                        }
                      }
                    },
                    {
                      "title": "Invalid file format",
                      "type": "object",
                      "properties": {
                        "decentroTxnId": {
                          "type": "string",
                          "example": "<decentro_txn_id>"
                        },
                        "status": {
                          "type": "string",
                          "example": "FAILURE"
                        },
                        "responseCode": {
                          "type": "string",
                          "example": "E00019"
                        },
                        "message": {
                          "type": "string",
                          "example": "File doesn't have necessary columns. Required columns are reference_id, purpose_message, account_number, ifsc"
                        }
                      }
                    }
                  ]
                }
              }
            }
          }
        }
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```