Returns all tags. Use the Range header to specify the number of tags returned (default is the first 20).

Query parameters

NameTypeDescriptionRequired?
query string When specified, the API returns only tags containing the specified string. false
sort string The attribute to sort returned tags by. name and created_at are valid. The default sort order is ascending. To sort the tags in descending order, include a minus sign (for example, -name). false

Responses

CodeReturns
200 The tag model for each tag
206 The tag model for each tag

Example

This example returns the first three tags.

Request

$ curl -X GET '/tags/' -H 'Authorization: Bearer <APIKEY>' -H 'Range: resources=0-2'

Response

[
    {
        "created_at": "2017-12-19T04:54:53.652491+00:00",
        "id": 1,
        "name": "agriculture"
    },
    {
        "created_at": "2018-01-02T22:12:58.371319+00:00",
        "id": 2,
        "name": "construction"
    },
    {
        "created_at": "2018-01-02T22:15:00.211372+00:00",
        "id": 3,
        "name": "technology"
    }
]