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

The saving ID

Example
f52b1f9e-b9a6-4248-afc5-d3ae358e723a

Query Parameters

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

The status of the transaction

actionType
string
Allowed values: DEPOSIT WITHDRAW

The action type of the transaction

fromDate
string

Start date in YYYY-MM-DDTHH:mm:ss format (UTC timezone, no offset allowed)

toDate
string

End date in YYYY-MM-DDTHH:mm:ss format (UTC timezone, no offset allowed)

sortOrder
string
default: desc
Allowed values: asc desc

The sort order by Date

page[number]
number

Page number (starts at 1)

Example
1
page[size]
number

Items per page

Example
10

Header Parameters

Section titled “Header Parameters ”
X-API-Key
string

API Key

X-API-Secret
string

API Secret

Responses

Section titled “ Responses ”

200

Section titled “200 ”

List of saving history entries

object
items
required
Array<object>
object
savingHistoryId
required

The history entry ID

string
f52b1f9e-b9a6-4248-afc5-d3ae358e723a
walletId
required

The wallet ID

string
f52b1f9e-b9a6-4248-afc5-d3ae358e723a
savingId
required

The saving ID

string
f52b1f9e-b9a6-4248-afc5-d3ae358e723a
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
f52b1f9e-b9a6-4248-afc5-d3ae358e723a
currencyId
required

The currency ID

string
f52b1f9e-b9a6-4248-afc5-d3ae358e723a
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
2024-03-20T10:30:00.000Z
updatedAt
required

Last update timestamp

string
2024-03-20T10:30:00.000Z
page
required
object
number
required

The current page number.

number
1
size
required

The number of items per page.

number
10
totalPages
required

The total number of pages available.

number
100
totalCount
required

The total number of items available.

number
1000
hasNext
required

Indicates whether there is a next page available.

boolean
true
hasPrev
required

Indicates whether there is a previous page available.

boolean
true