Toshl Developer

List tags

Get all users tags.

GET /tags

Required scope:

Parameters

page
optional
integer

Page to display, used for pagination.

Minimum: >= 0
Default value: 0
per_page
optional
integer

Number of resource objects to return.

Minimum: >= 10
Maximum: =< 500
Default value: 50
since
optional
string

Return all tags that were modified since timestamp.

Format: date-time
type
optional
string

Tag type

Possible values: expense, income
ids
optional
string

Comma separated list of tag ids.

categories
optional
string

Comma separated list of category ids. When set, only tags with selected categories are returned. If this is an empty list only tags that are not linked to a category are returned.

used_with_tags
optional
string

Comma separated list of tag ids. When set, only tags that were used with the selected tags are returned.

used_with_tags_min
optional
integer

Parameter is used in combination with used_with_tags parameter. Number of times the tag should be used with used_with_tags to be considered used with.

Minimum: >= 1
Default value: 1
used_with_categories
optional
string

Comma separated list of category ids. When set, only tags that were used with the selected categories are returned.

search
optional
string

Used to search tags.

include_deleted
optional
boolean

Include deleted tags.

* denotes required field/parameter.

Request

$ curl https://api.toshl.com/tags \
  -H "Authorization: Bearer T9cE5asGnuyYCCqIZFoWjFHvNbvVqHjl"

Response

HTTP/1.1 200 OK
Content-Type: application/json

[
  {
    "id": "42",
    "name": "coffee",
    "modified": "2012-09-04T13:55:15Z",
    "type": "expense",
    "category": "43",
    "count": 5,
    "deleted": 0
  }
]