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:
|
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
}
}