EscaGuideAPI Reference

Get Bulk Transfer Status

Check the status of all transfers in a bulk transfer batch.

GET /v1/virtual-account/bulk-transfer/:batchId

Path Parameters

Parameter Type Required Description
batchId string Yes Batch ID from bulk transfer response

Example Request 

curl -X GET "https://api.esca.finance/v1/virtual-account/bulk-transfer/api-1705574400000-12345" \
  -H "X-Api-Key: your_api_key_here"

Example Response 

{
  "status": true,
  "data": {
    "batchId": "api-1705574400000-12345",
    "summary": {
      "total": 2,
      "created": 0,
      "pending": 0,
      "successful": 2,
      "failed": 0
    },
    "transfers": [
      {
        "uuid": "550e8400-e29b-41d4-a716-446655440001",
        "status": "SUCCESSFUL",
        "amount": 10000,
        "currency": "NGN",
        "destinationAccountNumber": "0123456789",
        "destinationAccountName": "JOHN DOE",
        "destinationBankCode": "000007",
        "description": "Salary payment",
        "createdAt": "2026-01-18T10:30:00.000Z",
        "updatedAt": "2026-01-18T10:30:05.000Z"
      },
      {
        "uuid": "550e8400-e29b-41d4-a716-446655440002",
        "status": "SUCCESSFUL",
        "amount": 15000,
        "currency": "NGN",
        "destinationAccountNumber": "9876543210",
        "destinationAccountName": "JANE SMITH",
        "destinationBankCode": "058",
        "description": "Salary payment",
        "createdAt": "2026-01-18T10:30:00.000Z",
        "updatedAt": "2026-01-18T10:30:08.000Z"
      }
    ]
  }
}