Transfer API(s)
List Transfer
Lists all transfers.
GET
/
api
/
v1
/
transfer
/
list
curl --location --request GET 'https://api.recital.finance/api/v1/transfer/list\
--header 'Authorization: Bearer apiKey'{
"message": "Data retrieved successfully.",
"success": true,
"data": [
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "true",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PIN_CONFIRMATION",
"transferReference": "BAL-X2N420IP25SXDGAWO1CXLSHLRO",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "true",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PIN_CONFIRMATION",
"transferReference": "BAL-BART5YOK4G16226MLTL652XD0J",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "true",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PIN_CONFIRMATION",
"transferReference": "BAL-XZVJ3O1ML2HC0B4MZ52DJ2PKJ1",
"narration": "test"
},
{
"merchantID": "Sd5MCh2sdR",
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "09097657",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PIN_CONFIRMATION",
"transferReference": "BAL-8P0RK35YBCQ2222BOOK8HLQYN4",
"narration": "test"
},
{
"merchantID": "Sd5MCh2sdR",
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0909765709",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PIN_CONFIRMATION",
"transferReference": "BAL-UZKCE5YA2MV2PFVK8520B5OFX4",
"narration": "test"
},
{
"merchantID": "Sd5MCh2sdR",
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0909765709",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_APPROVAL",
"transferReference": "BAL-92T0DD54WVBWCHEE92NDIV2HED",
"narration": "test"
},
{
"merchantID": "Sd5MCh2sdR",
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0909765709",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PIN_CONFIRMATION",
"transferReference": "BAL-CCD04IV262BLSCYVAQV5QAC293",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0909765709",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PIN_CONFIRMATION",
"transferReference": "BAL-5HM82S525M2OZ4BTP0K6O4II93",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0909765709",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PIN_CONFIRMATION",
"transferReference": "BAL-25OW05U4SR2O9IICPKV7GZT935",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0909765709",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PIN_CONFIRMATION",
"transferReference": "BAL-2H1R3RU5GSHIY2YK8UTW8N4Y0L",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0909765709",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PIN_CONFIRMATION",
"transferReference": "BAL-LNW4E4FIIRB3X07F2G9D52LSUI",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0909765709",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_APPROVAL",
"transferReference": "BAL-5JA84TIA4JDX3YDFM24TP280CN",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0909765709",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_APPROVAL",
"transferReference": "BAL-WWVWXG22CI45T4Z5C0AQZOD3TB",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0001234567",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_APPROVAL",
"transferReference": "BAL-A0HW4LJUZ3HG50UY24320UP4JG",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0001234567",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_APPROVAL",
"transferReference": "BAL-X4YTKK830JK0Z2A3DLRODI2QU5",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0001234567",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_APPROVAL",
"transferReference": "BAL-W3L4NVFQAO87B02K2X58SDPH19",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0001234567",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_APPROVAL",
"transferReference": "BAL-GB4PDXK9YK42230TYVCWUCR3D5",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0001234567",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_APPROVAL",
"transferReference": "BAL-82549T2UD05ITWXTAAG08CHG4P",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0001234567",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_APPROVAL",
"transferReference": "BAL-D2HG0M524DS1AWPKYDKK4KGUYT",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0000000000",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_APPROVAL",
"transferReference": "BAL-4Q4W0PSLWAN061225XKYA4HO4R",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "01000000010",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_APPROVAL",
"transferReference": "BAL-88EQLYAUQ22424M5C4D00ZZGIS",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "01000000010",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_APPROVAL",
"transferReference": "BAL-0G42YICTGPZX5YZJ2TCEK14ZJC",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0100000001",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_APPROVAL",
"transferReference": "BAL-ELNI0ZIBPXYPM424WM22K5ENCL",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0100000001",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_APPROVAL",
"transferReference": "BAL-2V0B66SID5LBIOBK2N4HC4KP5C",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0000000000",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PROVIDER_CALLBACK",
"transferReference": "BAL-9C2WLP4OWD32GT252RU40EQ0PN",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0000000000",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PROVIDER_APPROVAL",
"transferReference": "BAL-I2RQIM4PVR2IS50HRTYIC4SU0G",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 1000,
"accountTo": "0000000000",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PROVIDER_APPROVAL",
"transferReference": "BAL-XLB4501ROL4Z2LY8LDP4STYR2Z",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 1000,
"accountTo": "0000000000",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PROVIDER_APPROVAL",
"transferReference": "BAL-TS04FL524IV2NZIHV3XMLJT4FR",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 1000,
"accountTo": "0000000000",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PROVIDER_CALLBACK",
"transferReference": "BAL-E7H4KQO5UIAW07HU423ZXOXOA2",
"narration": "test",
"externalReference": "BAL-E7H4KQO5UIAW07HU423ZXOXOA2"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 1000,
"accountTo": "0000000000",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PROVIDER_CALLBACK",
"transferReference": "BAL-GBZ4ASIGYH0RJBEP22WDL5422I",
"narration": "test",
"externalReference": "51pduf4yzu59xnavvqjz"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 1000,
"accountTo": "0000000000",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PROVIDER_CALLBACK",
"transferReference": "BAL-Q5N4HCPY21HOIFQUHZR02SNKF4",
"narration": "test",
"externalReference": "u7-88ysc2j27vk1k-pck"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 1000,
"accountTo": "0000000000",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PROVIDER_CALLBACK",
"transferReference": "BAL-DMCY224AV04FB50Z2BUHKDCSS8",
"narration": "test",
"externalReference": "6kgm5vmfaa7fn853gvrw"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 1000,
"accountTo": "0000000000",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PROVIDER_CALLBACK",
"transferReference": "BAL-DJ202TYZTCP5AFP4HW93LIAFY4",
"narration": "test",
"externalReference": "jbocxfak8-wpl0dovdwc"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 1000,
"accountTo": "0000000000",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PROVIDER_APPROVAL",
"transferReference": "BAL-IPT2E2KCGPW0ESN5B4YHG714WP",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0000000000",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PROVIDER_CALLBACK",
"transferReference": "BAL-50CNG8QAY4OWA4V0YR522CUDFN",
"narration": "test",
"externalReference": "gmxlmlkoeaj4k9xs4z-e"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0000000000",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PROVIDER_CALLBACK",
"transferReference": "BAL-7954OV5K2NBLA3T8J2PF0WCF40",
"narration": "test",
"externalReference": "xgz309wpku7ff7p4y-cm"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0000000000",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PROVIDER_CALLBACK",
"transferReference": "BAL-QCTI52I0545E52GOCX4VEVMOV1",
"narration": "test",
"externalReference": "lqu2cz0tvnzl-7cjw7qy"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0000000000",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PROVIDER_CALLBACK",
"transferReference": "BAL-PJ24QNWTDGNJ02G5AA4V0CPHEA",
"narration": "test",
"externalReference": "cn8z5-b5xyzunf0-69jz"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0000000000",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PROVIDER_CALLBACK",
"transferReference": "BAL-YA9S0J0UQKDVF4EXV2CK4RO5F2",
"narration": "test",
"externalReference": "TRF_t42bpnotlrcvl1i6"
}
]
}curl --location --request GET 'https://api.recital.finance/api/v1/transfer/list\
--header 'Authorization: Bearer apiKey'Response
Describes the result of the fetch operation.
Indicates whether the transfer retrieval was successful.
Contains the detailed information about the transfer (e.g., status, amount, beneficiary details, timestamps).
{
"message": "Data retrieved successfully.",
"success": true,
"data": [
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "true",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PIN_CONFIRMATION",
"transferReference": "BAL-X2N420IP25SXDGAWO1CXLSHLRO",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "true",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PIN_CONFIRMATION",
"transferReference": "BAL-BART5YOK4G16226MLTL652XD0J",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "true",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PIN_CONFIRMATION",
"transferReference": "BAL-XZVJ3O1ML2HC0B4MZ52DJ2PKJ1",
"narration": "test"
},
{
"merchantID": "Sd5MCh2sdR",
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "09097657",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PIN_CONFIRMATION",
"transferReference": "BAL-8P0RK35YBCQ2222BOOK8HLQYN4",
"narration": "test"
},
{
"merchantID": "Sd5MCh2sdR",
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0909765709",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PIN_CONFIRMATION",
"transferReference": "BAL-UZKCE5YA2MV2PFVK8520B5OFX4",
"narration": "test"
},
{
"merchantID": "Sd5MCh2sdR",
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0909765709",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_APPROVAL",
"transferReference": "BAL-92T0DD54WVBWCHEE92NDIV2HED",
"narration": "test"
},
{
"merchantID": "Sd5MCh2sdR",
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0909765709",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PIN_CONFIRMATION",
"transferReference": "BAL-CCD04IV262BLSCYVAQV5QAC293",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0909765709",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PIN_CONFIRMATION",
"transferReference": "BAL-5HM82S525M2OZ4BTP0K6O4II93",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0909765709",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PIN_CONFIRMATION",
"transferReference": "BAL-25OW05U4SR2O9IICPKV7GZT935",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0909765709",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PIN_CONFIRMATION",
"transferReference": "BAL-2H1R3RU5GSHIY2YK8UTW8N4Y0L",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0909765709",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PIN_CONFIRMATION",
"transferReference": "BAL-LNW4E4FIIRB3X07F2G9D52LSUI",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0909765709",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_APPROVAL",
"transferReference": "BAL-5JA84TIA4JDX3YDFM24TP280CN",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0909765709",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_APPROVAL",
"transferReference": "BAL-WWVWXG22CI45T4Z5C0AQZOD3TB",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0001234567",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_APPROVAL",
"transferReference": "BAL-A0HW4LJUZ3HG50UY24320UP4JG",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0001234567",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_APPROVAL",
"transferReference": "BAL-X4YTKK830JK0Z2A3DLRODI2QU5",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0001234567",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_APPROVAL",
"transferReference": "BAL-W3L4NVFQAO87B02K2X58SDPH19",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0001234567",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_APPROVAL",
"transferReference": "BAL-GB4PDXK9YK42230TYVCWUCR3D5",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0001234567",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_APPROVAL",
"transferReference": "BAL-82549T2UD05ITWXTAAG08CHG4P",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0001234567",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_APPROVAL",
"transferReference": "BAL-D2HG0M524DS1AWPKYDKK4KGUYT",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0000000000",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_APPROVAL",
"transferReference": "BAL-4Q4W0PSLWAN061225XKYA4HO4R",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "01000000010",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_APPROVAL",
"transferReference": "BAL-88EQLYAUQ22424M5C4D00ZZGIS",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "01000000010",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_APPROVAL",
"transferReference": "BAL-0G42YICTGPZX5YZJ2TCEK14ZJC",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0100000001",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_APPROVAL",
"transferReference": "BAL-ELNI0ZIBPXYPM424WM22K5ENCL",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0100000001",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_APPROVAL",
"transferReference": "BAL-2V0B66SID5LBIOBK2N4HC4KP5C",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0000000000",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PROVIDER_CALLBACK",
"transferReference": "BAL-9C2WLP4OWD32GT252RU40EQ0PN",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0000000000",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PROVIDER_APPROVAL",
"transferReference": "BAL-I2RQIM4PVR2IS50HRTYIC4SU0G",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 1000,
"accountTo": "0000000000",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PROVIDER_APPROVAL",
"transferReference": "BAL-XLB4501ROL4Z2LY8LDP4STYR2Z",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 1000,
"accountTo": "0000000000",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PROVIDER_APPROVAL",
"transferReference": "BAL-TS04FL524IV2NZIHV3XMLJT4FR",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 1000,
"accountTo": "0000000000",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PROVIDER_CALLBACK",
"transferReference": "BAL-E7H4KQO5UIAW07HU423ZXOXOA2",
"narration": "test",
"externalReference": "BAL-E7H4KQO5UIAW07HU423ZXOXOA2"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 1000,
"accountTo": "0000000000",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PROVIDER_CALLBACK",
"transferReference": "BAL-GBZ4ASIGYH0RJBEP22WDL5422I",
"narration": "test",
"externalReference": "51pduf4yzu59xnavvqjz"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 1000,
"accountTo": "0000000000",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PROVIDER_CALLBACK",
"transferReference": "BAL-Q5N4HCPY21HOIFQUHZR02SNKF4",
"narration": "test",
"externalReference": "u7-88ysc2j27vk1k-pck"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 1000,
"accountTo": "0000000000",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PROVIDER_CALLBACK",
"transferReference": "BAL-DMCY224AV04FB50Z2BUHKDCSS8",
"narration": "test",
"externalReference": "6kgm5vmfaa7fn853gvrw"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 1000,
"accountTo": "0000000000",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PROVIDER_CALLBACK",
"transferReference": "BAL-DJ202TYZTCP5AFP4HW93LIAFY4",
"narration": "test",
"externalReference": "jbocxfak8-wpl0dovdwc"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 1000,
"accountTo": "0000000000",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PROVIDER_APPROVAL",
"transferReference": "BAL-IPT2E2KCGPW0ESN5B4YHG714WP",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0000000000",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PROVIDER_CALLBACK",
"transferReference": "BAL-50CNG8QAY4OWA4V0YR522CUDFN",
"narration": "test",
"externalReference": "gmxlmlkoeaj4k9xs4z-e"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0000000000",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PROVIDER_CALLBACK",
"transferReference": "BAL-7954OV5K2NBLA3T8J2PF0WCF40",
"narration": "test",
"externalReference": "xgz309wpku7ff7p4y-cm"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0000000000",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PROVIDER_CALLBACK",
"transferReference": "BAL-QCTI52I0545E52GOCX4VEVMOV1",
"narration": "test",
"externalReference": "lqu2cz0tvnzl-7cjw7qy"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0000000000",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PROVIDER_CALLBACK",
"transferReference": "BAL-PJ24QNWTDGNJ02G5AA4V0CPHEA",
"narration": "test",
"externalReference": "cn8z5-b5xyzunf0-69jz"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0000000000",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PROVIDER_CALLBACK",
"transferReference": "BAL-YA9S0J0UQKDVF4EXV2CK4RO5F2",
"narration": "test",
"externalReference": "TRF_t42bpnotlrcvl1i6"
}
]
}Notes
- This endpoint is used to poll or verify the status of a transfer after it’s been initiated or finalized.
- The
datafield contains all attributes of the transfer including processing status and any errors.
Best Practices
✅ Always validate and store transferReference on initiation.
✅ Use this endpoint to build status update flows for your users.
✅ Combine with webhook events for more resilient tracking.
curl --location --request GET 'https://api.recital.finance/api/v1/transfer/list\
--header 'Authorization: Bearer apiKey'{
"message": "Data retrieved successfully.",
"success": true,
"data": [
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "true",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PIN_CONFIRMATION",
"transferReference": "BAL-X2N420IP25SXDGAWO1CXLSHLRO",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "true",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PIN_CONFIRMATION",
"transferReference": "BAL-BART5YOK4G16226MLTL652XD0J",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "true",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PIN_CONFIRMATION",
"transferReference": "BAL-XZVJ3O1ML2HC0B4MZ52DJ2PKJ1",
"narration": "test"
},
{
"merchantID": "Sd5MCh2sdR",
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "09097657",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PIN_CONFIRMATION",
"transferReference": "BAL-8P0RK35YBCQ2222BOOK8HLQYN4",
"narration": "test"
},
{
"merchantID": "Sd5MCh2sdR",
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0909765709",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PIN_CONFIRMATION",
"transferReference": "BAL-UZKCE5YA2MV2PFVK8520B5OFX4",
"narration": "test"
},
{
"merchantID": "Sd5MCh2sdR",
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0909765709",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_APPROVAL",
"transferReference": "BAL-92T0DD54WVBWCHEE92NDIV2HED",
"narration": "test"
},
{
"merchantID": "Sd5MCh2sdR",
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0909765709",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PIN_CONFIRMATION",
"transferReference": "BAL-CCD04IV262BLSCYVAQV5QAC293",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0909765709",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PIN_CONFIRMATION",
"transferReference": "BAL-5HM82S525M2OZ4BTP0K6O4II93",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0909765709",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PIN_CONFIRMATION",
"transferReference": "BAL-25OW05U4SR2O9IICPKV7GZT935",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0909765709",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PIN_CONFIRMATION",
"transferReference": "BAL-2H1R3RU5GSHIY2YK8UTW8N4Y0L",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0909765709",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PIN_CONFIRMATION",
"transferReference": "BAL-LNW4E4FIIRB3X07F2G9D52LSUI",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0909765709",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_APPROVAL",
"transferReference": "BAL-5JA84TIA4JDX3YDFM24TP280CN",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0909765709",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_APPROVAL",
"transferReference": "BAL-WWVWXG22CI45T4Z5C0AQZOD3TB",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0001234567",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_APPROVAL",
"transferReference": "BAL-A0HW4LJUZ3HG50UY24320UP4JG",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0001234567",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_APPROVAL",
"transferReference": "BAL-X4YTKK830JK0Z2A3DLRODI2QU5",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0001234567",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_APPROVAL",
"transferReference": "BAL-W3L4NVFQAO87B02K2X58SDPH19",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0001234567",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_APPROVAL",
"transferReference": "BAL-GB4PDXK9YK42230TYVCWUCR3D5",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0001234567",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_APPROVAL",
"transferReference": "BAL-82549T2UD05ITWXTAAG08CHG4P",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0001234567",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_APPROVAL",
"transferReference": "BAL-D2HG0M524DS1AWPKYDKK4KGUYT",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0000000000",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_APPROVAL",
"transferReference": "BAL-4Q4W0PSLWAN061225XKYA4HO4R",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "01000000010",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_APPROVAL",
"transferReference": "BAL-88EQLYAUQ22424M5C4D00ZZGIS",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "01000000010",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_APPROVAL",
"transferReference": "BAL-0G42YICTGPZX5YZJ2TCEK14ZJC",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0100000001",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_APPROVAL",
"transferReference": "BAL-ELNI0ZIBPXYPM424WM22K5ENCL",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0100000001",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_APPROVAL",
"transferReference": "BAL-2V0B66SID5LBIOBK2N4HC4KP5C",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0000000000",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PROVIDER_CALLBACK",
"transferReference": "BAL-9C2WLP4OWD32GT252RU40EQ0PN",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0000000000",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PROVIDER_APPROVAL",
"transferReference": "BAL-I2RQIM4PVR2IS50HRTYIC4SU0G",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 1000,
"accountTo": "0000000000",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PROVIDER_APPROVAL",
"transferReference": "BAL-XLB4501ROL4Z2LY8LDP4STYR2Z",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 1000,
"accountTo": "0000000000",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PROVIDER_APPROVAL",
"transferReference": "BAL-TS04FL524IV2NZIHV3XMLJT4FR",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 1000,
"accountTo": "0000000000",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PROVIDER_CALLBACK",
"transferReference": "BAL-E7H4KQO5UIAW07HU423ZXOXOA2",
"narration": "test",
"externalReference": "BAL-E7H4KQO5UIAW07HU423ZXOXOA2"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 1000,
"accountTo": "0000000000",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PROVIDER_CALLBACK",
"transferReference": "BAL-GBZ4ASIGYH0RJBEP22WDL5422I",
"narration": "test",
"externalReference": "51pduf4yzu59xnavvqjz"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 1000,
"accountTo": "0000000000",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PROVIDER_CALLBACK",
"transferReference": "BAL-Q5N4HCPY21HOIFQUHZR02SNKF4",
"narration": "test",
"externalReference": "u7-88ysc2j27vk1k-pck"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 1000,
"accountTo": "0000000000",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PROVIDER_CALLBACK",
"transferReference": "BAL-DMCY224AV04FB50Z2BUHKDCSS8",
"narration": "test",
"externalReference": "6kgm5vmfaa7fn853gvrw"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 1000,
"accountTo": "0000000000",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PROVIDER_CALLBACK",
"transferReference": "BAL-DJ202TYZTCP5AFP4HW93LIAFY4",
"narration": "test",
"externalReference": "jbocxfak8-wpl0dovdwc"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 1000,
"accountTo": "0000000000",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PROVIDER_APPROVAL",
"transferReference": "BAL-IPT2E2KCGPW0ESN5B4YHG714WP",
"narration": "test"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0000000000",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PROVIDER_CALLBACK",
"transferReference": "BAL-50CNG8QAY4OWA4V0YR522CUDFN",
"narration": "test",
"externalReference": "gmxlmlkoeaj4k9xs4z-e"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0000000000",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PROVIDER_CALLBACK",
"transferReference": "BAL-7954OV5K2NBLA3T8J2PF0WCF40",
"narration": "test",
"externalReference": "xgz309wpku7ff7p4y-cm"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0000000000",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PROVIDER_CALLBACK",
"transferReference": "BAL-QCTI52I0545E52GOCX4VEVMOV1",
"narration": "test",
"externalReference": "lqu2cz0tvnzl-7cjw7qy"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0000000000",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PROVIDER_CALLBACK",
"transferReference": "BAL-PJ24QNWTDGNJ02G5AA4V0CPHEA",
"narration": "test",
"externalReference": "cn8z5-b5xyzunf0-69jz"
},
{
"currency": "NGN",
"businessID": "FvhqyENCkHJAEPjfX8y6",
"amount": 100,
"accountTo": "0000000000",
"connectID": "ZIrfGJRaKjaGY62",
"status": "PENDING_PROVIDER_CALLBACK",
"transferReference": "BAL-YA9S0J0UQKDVF4EXV2CK4RO5F2",
"narration": "test",
"externalReference": "TRF_t42bpnotlrcvl1i6"
}
]
}Assistant
Responses are generated using AI and may contain mistakes.