Skip to content
FSCO Docs

Get saving history

GET
/v2/treasury/savings/{savingId}/history

Get the history for a specific saving with filters and pagination

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
savingId
required
string format: uuid 
d24d70a9-e1e2-4e83-ac81-cf62c2cb4c09

The saving ID

Query Parameters

Section titled “Query Parameters ”
status
required
string
Allowed values: PENDING COMPLETED FAILED 
PENDING

The status of the transaction

actionType
required
string
Allowed values: DEPOSIT WITHDRAW 
DEPOSIT

The action type of the transaction

fromDate
required
string
2025-01-01T00:00:00.000Z

The start date of the transaction

toDate
required
string
2025-01-01T00:00:00.000Z

The end date of the transaction

sortOrder
required
string
default: desc
Allowed values: asc desc 
desc

The sort order by Date

page

Object with the page number and the number of items per page

object
number
required

Page number (starts at 1)

number
1
size
required

Items per page

number
10
totalPages
required

Total number of items

number
100
totalCount
required

Total number of pages

number
10
hasNext
required

Whether there is a next page

boolean
true
hasPrev
required

Whether there is a previous page

boolean

Responses

Section titled “ Responses ”

200

Section titled “200 ”

List of saving history entries

object
items
required

List of saving history items

Array<object>
object
savingHistoryId
required

The history entry ID

string format: uuid 
d24d70a9-e1e2-4e83-ac81-cf62c2cb4c09
walletId
required

The wallet ID

string format: uuid 
d24d70a9-e1e2-4e83-ac81-cf62c2cb4c09
savingId
required

The saving ID

string format: uuid 
d24d70a9-e1e2-4e83-ac81-cf62c2cb4c09
actionType
required

The action type, either “deposit” or “withdraw”

string
Allowed values: DEPOSIT WITHDRAW
status
required

The current status, e.g., “pending”, “completed”, “failed”

string
Allowed values: PENDING COMPLETED FAILED
feeStatus
required

The status of the fee processing, similar to transaction status

string
Allowed values: PENDING COMPLETED FAILED
txQueryId

The transaction query ID

string format: uuid 
d24d70a9-e1e2-4e83-ac81-cf62c2cb4c09
currencyId
required

The currency ID

string format: uuid 
d24d70a9-e1e2-4e83-ac81-cf62c2cb4c09
totalValue
required

Total value involved in the transaction

string
100.123456
customerInputValue
required

Customer’s original input value before any deductions

string
100.123456
customerValue
required

Final customer value after applying fees or deductions

string
98.123456
customerFeeValue
required

Customer-specific fee amount

string
1.000000
adminFeeValue
required

Admin fee calculated from the transaction

string
1.000000
paidAdminFeeValue
required

Amount of admin fee that has already been paid

string
1.000000
preBalance
required

Customer’s balance before the transaction

string
1000.123456
postBalance
required

Customer’s balance after the transaction

string
1100.123456
createdAt
required

The transaction timestamp

string format: date-time 
2024-03-20T10:30:00.000Z
updatedAt
required

Last update timestamp

string format: date-time 
2024-03-20T10:30:00.000Z
page
required

Pagination information

object
number
required

Page number (starts at 1)

number
1
size
required

Items per page

number
10
totalPages
required

Total number of items

number
100
totalCount
required

Total number of pages

number
10
hasNext
required

Whether there is a next page

boolean
true
hasPrev
required

Whether there is a previous page

boolean

400

Section titled “400 ”

Bad Request

401

Section titled “401 ”

Unauthorized

403

Section titled “403 ”

Forbidden

404

Section titled “404 ”

Not Found

500

Section titled “500 ”

Internal Server Error