List Tags on Item

This endpoint returns a paginated list of all the tags added to an item.

Request

GET https://v2.api.uberflip.com/items/{itemId}/tags
Path Parameters Description
itemId The unique identifier of the item
Query Parameters Description
limit Number of results to return
page Page to show
sort

Sort results by one or more of the following fields:

  • id
  • tag_group_id
  • name
  • description
  • items_count
  • created_at
  • modified_at

Response

The response will contain a tags collection:

Body Parameters Type Description
data Array The collection of tags
meta Object See: Pagination

Each tag in the collection will have properties:

Body Parameters Properties Type Description
id   Integer The tag identifier
tag_group_id   Integer The tag group identifier
name   String The tag title
description   String The tag description
items_count   String The tag URL
created_at   Date The tag created date
modified_at   Date The tag last modified date

Examples

curl -H "Authorization: Bearer [Token]" \
-i https://v2.api.uberflip.com/items/{itemId}/tags

Sample response:

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

{
    "data": [
        {
            "id": 123,
            "tag_group_id": 5439,
            "name": "tag123",
            "description": "",
            "items_count": 6,
            "created_at": "2017-09-19T10:06:26-0400",
            "modified_at": "2017-09-19T10:06:26-0400"
        },
        {
            "id": 456,
            "tag_group_id": 5439,
            "name": "tag456",
            "description": "",
            "items_count": 1,
            "created_at": "2018-08-13T22:58:08-0400",
            "modified_at": "2018-08-13T22:58:08-0400"
        }
    ],
    "meta": {
        "count": 2,
        "limit": 25,
        "total_pages": 1
    }
}