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: application/json' \
  --data '{
  "file": "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.

Query Parameters

​
category
string
required

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

​
currency
string
required

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

​
narration
string
required

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

Body

application/json
​
file
file
required

Upload the file content and must in CSV format.

Response

A JSON array of create bulk disbursement objects.

​
reference
string<uuid>
Example:

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

​
spotflowreference
string<uuid>
Example:

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

​
amount
number
Example:

0

​
currency
string
Example:

"NGN"

​
transferMode
string
Example:

"7706438396"

​
destination
object
​
narrations
string
Example:

"string"

​
status
string
Example:

"string"