Skip to main content
POST
/
bank-transactions
Create bank transaction
curl --request POST \
  --url https://staging-api.usetyms.com/v1/adam/bank-transactions \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "bank": "f9e8d7c6b5a4438291f0e9d8c7b6a5948",
  "amount": 45000,
  "type": "debit",
  "date": "2026-03-06",
  "narration": "POS settlement — March 6",
  "balance": 1250000,
  "exchange_rate": 1,
  "group_reference": "BATCH-20260306-01",
  "apply_adam_rule": true,
  "source": "manually_added"
}
'
import requests

url = "https://staging-api.usetyms.com/v1/adam/bank-transactions"

payload = {
"bank": "f9e8d7c6b5a4438291f0e9d8c7b6a5948",
"amount": 45000,
"type": "debit",
"date": "2026-03-06",
"narration": "POS settlement — March 6",
"balance": 1250000,
"exchange_rate": 1,
"group_reference": "BATCH-20260306-01",
"apply_adam_rule": True,
"source": "manually_added"
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
bank: 'f9e8d7c6b5a4438291f0e9d8c7b6a5948',
amount: 45000,
type: 'debit',
date: '2026-03-06',
narration: 'POS settlement — March 6',
balance: 1250000,
exchange_rate: 1,
group_reference: 'BATCH-20260306-01',
apply_adam_rule: true,
source: 'manually_added'
})
};

fetch('https://staging-api.usetyms.com/v1/adam/bank-transactions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
{
  "status": "success",
  "message": "Bank transaction created successfully",
  "data": {
    "uuid": "f6a7b8c9d0e1428290a1b2c3d4e5f6b8",
    "type": "debit"
  }
}
{
"status": "failed",
"message": "<string>"
}

Authorizations

X-API-Key
string
header
default:your_tyms_sk_or_partner_key
required

Business secret tyms_sk_... for business-scoped routes. Partner secret for register-business and referred-business distributor routes.

Body

application/json
bank
string
required

Bank uuid. Alias: bank_uuid.

amount
number
required

Positive amount.

type
enum<string>
required

credit = money in, debit = money out.

Available options:
credit,
debit
date
string<date>
required
narration
string
required
balance
number
exchange_rate
number
group_reference
string
batch_id
string
apply_bank_rules
boolean
apply_adam_rule
boolean
source
string

Response

Created

status
string
required
Example:

"success"

message
string
required
data
any

Single resource, array of resources, statement sections, or async job metadata — see each operation's example.

meta
object

Pagination (page, limit, total) and/or report range (from, to). Cash flow may include previous_period_end.