List the tags applied to contacts. Each item is a single contact-to-tag association, and its id is the value to pass to DELETE /contactTags/{id} when removing a tag from a contact.
Filter by contact, by tag, or by both to look up a specific association. Note that the filters use the underlying column names subscriberid and tagid, while the response returns the same values as contact and tag — filters[contact] and filters[tag] are not supported.
Unrecognized filter and order parameters are silently ignored, so a request with a misspelled filter looks successful while returning the unfiltered set.
Associations whose tag has since been deleted are still listed here and counted in meta.total; GET /tags/{id} for such a tag returns 404. The contact's own listing, GET /contacts/{id}/contactTags, hides them.
To get the contacts that carry a tag, rather than the association rows, use GET /contacts with tagid, or filters[tagName] for a tag name.
filters[cdate] matches one exact timestamp, not a day or a range. To answer "which contacts got tag X since a date", filter by filters[tagid], order with orders[cdate]=desc and stop paging when cdate passes the date.
No permission beyond API access is checked, so any API user can list every association in the account, including contacts that are not on their lists. Associations whose contact no longer exists are left out.
403The request has no valid API token. The body is empty.
