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