Skip to main content
POST
/
transfers
cURL
curl --request POST \
  --url https://api.spotflow.co/api/v1/transfers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "reference": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "amount": 123,
  "currency": "<string>",
  "type": "<string>",
  "source": {
    "accountNumber": "<string>"
  },
  "destination": {
    "accountNumber": "<string>",
    "accountName": "<string>",
    "bankCode": "<string>",
    "branchCode": "<string>"
  },
  "narrations": "<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

application/json
​
reference
string<uuid>
required
​
amount
integer<float>
required
​
currency
string
required
​
type
string
required
​
source
object
required
​
destination
object
required
​
narrations
string

Response

A JSON array of create single disbursement objects.

​
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"