REST API

REST API

Legacy Poppulo platform REST API

List Subscriber Tags

Overview

NameDescription
HTTP MethodGET
URLhttps://api.newsweaver.com/v2/{account code}/subscriber/{subscriber identifier}/tags
https://api.newsweaver.com/v2/{account code}/subscriber/{subscriber email}/tags
Query ParametersN/A
Request representationN/A
Response representationSubscriber Tag List
Success Response Code200 Ok

Errors

  • 403 - Forbidden if API user doesn't have READ access to GLOBAL_SUBSCRIBERS and TAGS
  • 404 - Not Found if subscriber doesn't exist
  • Common errors (user/account authentication errors, API usage limit errors)

Example: GET https://api.newsweaver.com/v2/sample-account/subscriber/joe.bloggs@example.com/tags

<subscriber_tags total="2" uri="https://api.newsweaver.com/v2/example-account/subscriber/joe.bloggs@example.com/tags">
    <itemsPerPage>1000</itemsPerPage>
    <startIndex>0</startIndex>
    <totalResults>2</totalResults>
    <subscriber_tag name="Computer Science" uri="https://api.newsweaver.com/v2/example-account/subscriber/1dc0ag2floc/tag/Computer%20Science">
         <link
             href="https://api.newsweaver.com/v2/example-account/subscriber/1dc0ag2floc"
             rel="http://api-info.newsweaver.com/v2/rels/subscriber_tag.subscriber"
             title="Subscriber (1dc0ag2floc)"/>
         <link
             href="https://api.newsweaver.com/v2/example-account/tag/Computer%20Science"
             rel="http://api-info.newsweaver.com/v2/rels/subscriber_tag.tag"
             title="Tag (Computer Science)"/>
    </subscriber_tag>
    <subscriber_tag name="Philosophy" uri="https://api.newsweaver.com/v2/example-account/subscriber/1dc0ag2floc/tag/Philosophy">
         <link
             href="https://api.newsweaver.com/v2/example-account/subscriber/1dc0ag2floc"
             rel="http://api-info.newsweaver.com/v2/rels/subscriber_tag.subscriber"
             title="Subscriber (1dc0ag2floc)"/>
         <link
             href="https://api.newsweaver.com/v2/example-account/tag/Philosophy"
             rel="http://api-info.newsweaver.com/v2/rels/subscriber_tag.tag"
             title="Tag (Philosophy)"/>
     </subscriber_tag>
</subscriber_tags>