Toshl Developer

Create report

Create a new report.

POST /reports

Required scope:

Parameters

emails
optional
array

An array of emails to send the export file. If not set users default email is used.

resources (deprecated)
optional
array

An array of resources to export.

Possible values: expenses, incomes, budgets, summary, attachments, attachments_grid, balances
formats (deprecated)
optional
array

An array of export formats.

Possible values: csv, xls, pdf, ofx
accounts (deprecated)
optional
array

An array of accounts to export. Default is to export all accounts.

!accounts (deprecated)
optional
array

An array of accounts to not export. Default is to export all accounts.

categories (deprecated)
optional
array

An array of categories to export. Default is to export all categories.

!categories (deprecated)
optional
array

An array of categories to not export. Default is to export all categories.

tags (deprecated)
optional
array

An array of tags to export. Default is to export all tags.

!tags (deprecated)
optional
array

An array of tags to not export. Default is to export all tags.

locations (deprecated)
optional
array

An array of locations to export. Default is to export all locations.

!locations (deprecated)
optional
array

An array of locations to not export. Default is to export all locations.

frequency (deprecated)
optional
string

Report frequency

Possible values: weekly, monthly
export
optional
object

Export details. Sent only if export files should be attached to report emails

resources
optional
array

An array of resources to export.

Possible values: expenses, incomes, budgets, summary, attachments, attachments_grid, balances
formats
optional
array

An array of export formats.

Possible values: csv, xls, pdf, ofx
filters
optional
object

Export filter settings (accounts, categories, tags …)

accounts
optional
array

An array of accounts to export. Default is to export all accounts.

!accounts
optional
array

An array of accounts to not export. Default is to export all accounts.

expenses
optional
object

Expense export filter settings for categories and tags.

incomes
optional
object

Income export filter settings for categories and tags.

locations
optional
array

An array of locations to export. Default is to export all locations.

!locations
optional
array

An array of locations to exclude.

include
optional
object

Which parts of reports should be included.

account_balances
optional
boolean

Include account balances in report.

networth
optional
boolean

Include networth in report.

frequencies
optional
array

List of enabled report frequencies.

Possible values: weekly, monthly, yearly
status
optional
string

Report status.

Possible values: active, inactive

* denotes required field/parameter.

Request

$ curl https://api.toshl.com/reports \
  -H "Authorization: Bearer T9cE5asGnuyYCCqIZFoWjFHvNbvVqHjl" \
  -H "Content-Type: application/json" \
  -X POST \
  -d '{json}'

Response

HTTP/1.1 201 Created
Location: https://api.toshl.com/reports/42