List tags
Get all users tags.
GET /tags
Required scope:
- tags:r
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
}
]