Toshl Developer

Bank import

Bank (and other institutions) exports can now be imported and processed by Toshl.

Note: Be advised, this part is changing rapidly and breaking changes will be made. You have been warned.

Properties

id
readonly
string

Import id.

account
read, write
string

Account id the data was imported to

modified
readonly
string

Specifies when the import was last modified.

status
readonly
string

Import status. hints is used for CSV and XLS files which require an additional step in processing – the selection of hints. See preview for more info.

Possible values: new, hints, date_formats, processing, error, completed
error
readonly
string

Import error in case status is error

Possible values: unknown, amount, date, hints
preview
read, write
array

Preview includes CSV/XLS file preview of the header and a couple of lines, to show to the user.

name
read, write
string

In case of XLS files, sheet name is returned. Otherwise this parameter is skipped.

hints
readonly
array

Header hints. Tries to guess hint type based on previous selections.

Possible values: date, amount, expense, income, currency, description, payee, account, category, tags, skip
header
readonly
array

Array of file header column names

rows
readonly
array

A few row previews

metadata
read, write
object

Information about the imported file

expenses
readonly
integer

Expense count

incomes
readonly
integer

Income count

from
readonly
string

From timespan date

Format: date
to
readonly
string

To timespan date

Format: date
formats
read, write
object

Date formatting

available
read, write
array

Available date formats to choose from

selected
read, write
string

Selected date format. This will then be used to parse all the dates.

examples
read, write
array

Date examples

filename
read, write
string

Name of the uploaded file