API Docs

List Tags

Get a complete list of your tags using REST API endpoint: /api/v1/tags

Request

Parameter Type Position # Description
apikey string Header Required Enter your 20-30 characters unique api key.
apisecret string Header Required Enter your 12-20 characters unique api secret.
page integer Query Optional This param defines which page of the pagination to load.
Default: 1
pagesize integer Query Optional This param defines how many tags to load on a single page.
Default: 50
Maximum value: 500
orderby string Query Optional This param defines the sorting order of the resulting tags. Allowed values for this parameter are:
  • date => sort in ascending order by creation date (chronological order)
  • -date => sort in descending order by creation date (latest first)
Default: sort as latest first

Sample GET request


1. https://t2mio.com/api/v1/tags
2. https://t2mio.com/api/v1/tags?page=1&pagesize=50&orderby=date
3. https://t2mio.com/api/v1/tags?page=1&pagesize=50&orderby=-date

Response

{
    "status": 200,
    "message": "ok",
    "data": {
        "page": 1,
        "pageSize": 50,
        "items": [
            {
                "id": 110,
                "name": "sample-tag",
                "description": "sample tag description",
                "createdAt": "2022-01-29 13:31:58"
            },
            ...
        ]
    }
}

											
{
    "status": 400,
    "message": "Bad request. <detailed-error-message-will-go-here>.",
    "data": null
}
											
{
    "status": 401,
    "message": "Api key and secret is not valid or missing."
}