Account ledger
curl --request GET \
--url https://staging-api.usetyms.com/v1/adam/reports/account-ledger/{uuid} \
--header 'X-API-Key: <api-key>'import requests
url = "https://staging-api.usetyms.com/v1/adam/reports/account-ledger/{uuid}"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://staging-api.usetyms.com/v1/adam/reports/account-ledger/{uuid}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"status": "success",
"message": "Ledger retrieved successfully",
"data": {
"data": {
"current_page": 1,
"data": [
{
"uuid": "mj333333333333333333333333333333",
"transaction_no": "INV-1042",
"transaction_type": "invoice",
"narration": "Website design services — March",
"account": "Accounts Receivable",
"account_type": "Assets",
"debit_amount": 150000,
"credit_amount": 0,
"currency": "NGN",
"date": "2026-03-01T00:00:00.000000Z",
"opening_balance": 0,
"closing_balance": 150000
}
],
"per_page": 100,
"total": 1
},
"balance": 150000,
"side": "Debit",
"currency": "NGN",
"account_name": "Accounts Receivable",
"account_currency": "NGN",
"date": "2026-03-31T23:59:59.000000Z"
}
}{
"status": "failed",
"message": "<string>"
}Reports
Account ledger
Running balance ledger for a single chart-of-account or bank account. Pass a COA uuid or bank uuid as {uuid}. Returns all movements with opening and closing balance per line, plus the period closing balance and debit/credit side.
GET
/
reports
/
account-ledger
/
{uuid}
Account ledger
curl --request GET \
--url https://staging-api.usetyms.com/v1/adam/reports/account-ledger/{uuid} \
--header 'X-API-Key: <api-key>'import requests
url = "https://staging-api.usetyms.com/v1/adam/reports/account-ledger/{uuid}"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://staging-api.usetyms.com/v1/adam/reports/account-ledger/{uuid}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"status": "success",
"message": "Ledger retrieved successfully",
"data": {
"data": {
"current_page": 1,
"data": [
{
"uuid": "mj333333333333333333333333333333",
"transaction_no": "INV-1042",
"transaction_type": "invoice",
"narration": "Website design services — March",
"account": "Accounts Receivable",
"account_type": "Assets",
"debit_amount": 150000,
"credit_amount": 0,
"currency": "NGN",
"date": "2026-03-01T00:00:00.000000Z",
"opening_balance": 0,
"closing_balance": 150000
}
],
"per_page": 100,
"total": 1
},
"balance": 150000,
"side": "Debit",
"currency": "NGN",
"account_name": "Accounts Receivable",
"account_currency": "NGN",
"date": "2026-03-31T23:59:59.000000Z"
}
}{
"status": "failed",
"message": "<string>"
}Authorizations
Business secret tyms_sk_... for business-scoped routes. Partner secret for register-business and referred-business distributor routes.
Path Parameters
Chart-of-account uuid or bank account uuid.
Query Parameters
Period start date (Y-m-d). Alias: from_date.
Alias for from.
Period end date (Y-m-d). Alias: to_date.
Alias for to.
Pass 1 to return raw data only without the status/message wrapper.
Available options:
1 Page size (default 100).
Page number.
Response
Account ledger with running balance