get
https://{youraccountname}.api-us1.com/api/3/tags
Returns tag definitions. Contact tags are returned by default; pass type=template for template tags. To find a tag by exact name, use filters[tag] or filters[search][eq]; for a partial-name search, use search. To apply a tag to a contact, pass the returned id to POST /contactTags. Unrecognized filter and order parameters are silently ignored. When that happens the response contains the unfiltered set with the unfiltered total, so a request with a misspelled filter looks successful while returning every tag. Results are sorted by id ascending unless orders[search]=weight applies. meta.total is the number of tags that matched, returned as a string.
{
"tags": [
{
"tagType": "contact",
"tag": "one",
"description": "",
"cdate": "2018-08-17T09:43:15-05:00",
"links": {
"contactGoalTags": "https://:account.api-us1.com/api/:version/tags/1/contactGoalTags"
},
"id": "1"
},
{
"tagType": "contact",
"tag": "two",
"description": "",
"cdate": "2018-08-17T13:41:16-05:00",
"links": {
"contactGoalTags": "https://:account.api-us1.com/api/:version/tags/2/contactGoalTags"
},
"id": "2"
},
{
"tagType": "contact",
"tag": "three",
"description": "",
"cdate": "2018-08-17T13:41:18-05:00",
"links": {
"contactGoalTags": "https://:account.api-us1.com/api/:version/tags/3/contactGoalTags"
},
"id": "3"
},
{
"tagType": "template",
"tag": "test1",
"description": "",
"cdate": "2018-08-28T11:54:36-05:00",
"links": {
"contactGoalTags": "https://:account.api-us1.com/api/:version/tags/4/contactGoalTags"
},
"id": "4"
},
{
"tagType": "template",
"tag": "test2",
"description": "",
"cdate": "2018-08-28T11:54:38-05:00",
"links": {
"contactGoalTags": "https://:account.api-us1.com/api/:version/tags/5/contactGoalTags"
},
"id": "5"
}
],
"meta": {
"total": "5"
}
}