List Tags¶
This endpoint returns a paginated list of all the tags in an account.
Request¶
GET https://v2.api.uberflip.com/tags
| Query Parameters | Description |
|---|---|
| query | Return only results containing the specified text in one or more of the following fields:
|
| 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/tags
Sample response:
HTTP/1.1 200 OK
Content-Type: application/json
{
"data": [
{
"id": 123,
"tag_group_id": 103234,
"name": "tag123",
"description": null,
"items_count": 1,
"created_at": "2017-06-21T09:49:28-0400",
"modified_at": "2017-06-21T09:49:28-0400"
},
{
"id": 456,
"tag_group_id": 5439,
"name": "tag456",
"description": "",
"items_count": 10,
"created_at": "2017-09-19T10:06:21-0400",
"modified_at": "2018-08-08T13:39:19-0400"
},
{
"id": 789,
"tag_group_id": 5439,
"name": "tag789",
"description": "",
"items_count": 5,
"created_at": "2017-09-19T10:06:26-0400",
"modified_at": "2017-09-19T10:06:26-0400"
},
{
"id": 1123,
"tag_group_id": 5439,
"name": "tag1123",
"description": "",
"items_count": 0,
"created_at": "2017-09-19T10:06:48-0400",
"modified_at": "2017-09-19T10:06:48-0400"
},
{
"id": 1456,
"tag_group_id": 5439,
"name": "tag1456",
"description": null,
"items_count": 1,
"created_at": "2018-01-03T10:02:39-0500",
"modified_at": "2018-01-03T10:02:39-0500"
},
{
"id": 1789,
"tag_group_id": 5439,
"name": "tag1789",
"description": null,
"items_count": 1,
"created_at": "2018-01-03T10:10:12-0500",
"modified_at": "2018-01-03T10:10:12-0500"
},
{
"id": 2123,
"tag_group_id": 5439,
"name": "tag2123",
"description": null,
"items_count": 0,
"created_at": "2018-03-14T11:04:36-0400",
"modified_at": "2018-03-14T11:04:36-0400"
},
{
"id": 2456,
"tag_group_id": 5439,
"name": "tag2456",
"description": null,
"items_count": 1,
"created_at": "2018-06-04T11:10:04-0400",
"modified_at": "2018-06-04T11:10:04-0400"
},
{
"id": 2789,
"tag_group_id": 5439,
"name": "tag2789",
"description": null,
"items_count": 1,
"created_at": "2018-06-04T11:10:06-0400",
"modified_at": "2018-06-04T11:10:06-0400"
},
{
"id": 3123,
"tag_group_id": 5439,
"name": "tag3123",
"description": null,
"items_count": 1,
"created_at": "2018-06-04T11:10:09-0400",
"modified_at": "2018-06-04T11:10:09-0400"
},
{
"id": 3456,
"tag_group_id": 5439,
"name": "tag3456",
"description": null,
"items_count": 0,
"created_at": "2018-06-07T14:53:01-0400",
"modified_at": "2018-06-07T14:53:01-0400"
},
{
"id": 3789,
"tag_group_id": 5439,
"name": "tag3789",
"description": null,
"items_count": 0,
"created_at": "2018-06-07T14:53:05-0400",
"modified_at": "2018-06-07T14:53:05-0400"
},
{
"id": 4123,
"tag_group_id": 5439,
"name": "tag4123",
"description": null,
"items_count": 0,
"created_at": "2018-06-07T14:53:08-0400",
"modified_at": "2018-06-07T14:53:08-0400"
},
{
"id": 4456,
"tag_group_id": 5439,
"name": "tag4456",
"description": null,
"items_count": 0,
"created_at": "2018-06-07T14:53:15-0400",
"modified_at": "2018-06-07T14:53:15-0400"
},
{
"id": 4789,
"tag_group_id": 5439,
"name": "tag4789",
"description": null,
"items_count": 0,
"created_at": "2018-06-07T14:53:36-0400",
"modified_at": "2018-06-07T14:53:36-0400"
},
{
"id": 5123,
"tag_group_id": 5439,
"name": "tag5123",
"description": null,
"items_count": 0,
"created_at": "2018-06-07T14:54:44-0400",
"modified_at": "2018-06-07T14:54:44-0400"
},
{
"id": 5456,
"tag_group_id": 5439,
"name": "tag5456",
"description": null,
"items_count": 0,
"created_at": "2018-07-05T14:30:39-0400",
"modified_at": "2018-07-05T14:30:39-0400"
},
{
"id": 5789,
"tag_group_id": 5439,
"name": "tag5789",
"description": null,
"items_count": 0,
"created_at": "2018-07-09T16:14:17-0400",
"modified_at": "2018-07-09T16:14:17-0400"
},
{
"id": 6123,
"tag_group_id": 5439,
"name": "tag6123",
"description": null,
"items_count": 2,
"created_at": "2018-07-09T16:14:36-0400",
"modified_at": "2018-07-09T16:14:36-0400"
},
{
"id": 6456,
"tag_group_id": 5439,
"name": "tag6456",
"description": null,
"items_count": 1,
"created_at": "2018-07-30T09:48:56-0400",
"modified_at": "2018-07-30T09:48:56-0400"
},
{
"id": 6789,
"tag_group_id": 5439,
"name": "tag6789",
"description": null,
"items_count": 1,
"created_at": "2018-07-30T09:51:48-0400",
"modified_at": "2018-07-30T09:51:48-0400"
},
{
"id": 7123,
"tag_group_id": 5439,
"name": "tag7123",
"description": null,
"items_count": 1,
"created_at": "2018-07-30T13:57:48-0400",
"modified_at": "2018-07-30T13:57:48-0400"
},
{
"id": 7456,
"tag_group_id": 5439,
"name": "tag7456",
"description": null,
"items_count": 1,
"created_at": "2018-07-30T13:58:14-0400",
"modified_at": "2018-07-30T13:58:14-0400"
},
{
"id": 7789,
"tag_group_id": 5439,
"name": "tag7789",
"description": null,
"items_count": 2,
"created_at": "2018-07-31T12:24:15-0400",
"modified_at": "2018-07-31T12:24:15-0400"
},
{
"id": 8123,
"tag_group_id": 5439,
"name": "tag8123",
"description": null,
"items_count": 2,
"created_at": "2018-07-31T12:27:12-0400",
"modified_at": "2018-07-31T12:27:12-0400"
}
],
"meta": {
"count": 31,
"limit": 25,
"total_pages": 2,
"next_page": "https://v2.api.uberflip.com/tags?page=2"
}
}