Skip to main content
POST
/
transfers
/
bulk
cURL
curl --request POST \
  --url https://api.spotflow.co/api/v1/transfers/bulk \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form file='@example-file' \
  --form 'category=<string>' \
  --form currency=NGN \
  --form 'narration=<string>'
{
  "reference": "c1fba25a-a36b-479c-b17d-64dbaf3ba32c",
  "spotflowreference": "c1fba25a-a36b-479c-b17d-64dbaf3ba32c",
  "amount": 0,
  "currency": "NGN",
  "transferMode": "7706438396",
  "destination": {
    "accountNumber": "7706438396",
    "accountName": "Quantum Technologies",
    "bankCode": "NGN100",
    "branchCode": "NGN100",
    "bankName": "Testbank MFB"
  },
  "narrations": "string",
  "status": "string"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

multipart/form-data
​
file
file
required

CSV file containing bulk transfer data. Must be a .csv file.

​
category
string
required

Specify a unique category of your choice for your company to track a transaction for later reconciliation.

​
currency
enum<string>
required

Select the currency for the transfer. This is in our supported currency which is currently only NGN and GHS.

Available options:
NGN,
GHS
​
narration
string
required

This is optional information for you to give details about the reason for the transfer

Response

Bulk transfer created successfully.

​
reference
string<uuid>
Example:

"c1fba25a-a36b-479c-b17d-64dbaf3ba32c"

​
spotflowreference
string<uuid>
Example:

"c1fba25a-a36b-479c-b17d-64dbaf3ba32c"

​
amount
number<int32>
Example:

0

​
currency
string
Example:

"NGN"

​
transferMode
string
Example:

"7706438396"

​
destination
object
​
narrations
string
Example:

"string"

​
status
string
Example:

"string"