Developers & API: Interest Subscriptions

Get a list of subscriptions for an interest

Get a list of active subscriptions associated to an interest.

URL:

http://api.optitmobile.com/1/interests/{interest_id}/subscriptions.{format}

Format:

xml, json

HTTP Method:

GET

Parameters:

• phone - mobile phone number of the member with country code - 1 for U.S. phone numbers.  Example: 12225551212
• member_id - the member_id of a member. It is the ID attribute in the Members entity and can be viewed using the Get Member method.
• first_name - first name of the member
• last_name - last name of the member
• zip - zip code or postal code of the member
• gender - gender of the member. Values: [male, female]
• signup_date_start - yyyymmddhhmmss
• signup_date_end - yyyymmddhhmmss

XML Response

<?xml version="1.0" encoding="UTF-8"?>
<subscriptions type="array" current_page="1" total_pages="1">
    <subscription>
        <type>mobile</type>
        <phone>12225551212</phone>
        <member_id>123456</member_id>
        <signup_date>06/10/04 10:40 AM Central Standard Time</signup_date>
        <created_at >06/10/04 10:40 AM Central Standard Time</created_at>
        <url>http://api.optitmobile.com/1/keywords/{keyword_id}/subscriptions/{phone}.{format}</url>
    </subscription>
    <subscription>
        .......
    </subscription>
</subscriptions>

Add a subscription to an interest.

Add a subscribed member to an interest.

URL:

http://api.optitmobile.com/1/interests/{interest_id}/subscriptions.{format}

Format:

xml, json

HTTP Method:

POST

Parameters:

phone - mobile phone number of the member with country code - 1 for U.S. phone numbers. (Phone or member_id is required)  Example: 12225551212

member_id - the member_id of a member. It is the ID attribute in the Members entity and can be viewed using the Get Member method. (Phone or member_id is required)

XML Response

<?xml version="1.0" encoding="UTF-8"?>
    <subscription>
        <type>mobile</type>
        <phone>12225551212</phone>
        <member_id>123456</member_id>
        <signup_date>06/10/04 10:40 AM Central Standard Time</signup_date>
        <created_at >06/10/04 10:40 AM Central Standard Time</created_at>
    </subscription>

Delete an subscription from an interest

Delete a subscribed member from an interest.

URL:

http://api.optitmobile.com/1/interests/{interest_id}/subscriptions/{phone}.{format}

Format:

xml, json

HTTP Method:

DELETE

XML Response

<?xml version="1.0" encoding="UTF-8"?>
    <subscription>
        <request_id>1b856ad4-2403-4600-96bd-8bf0959cbc8a</request_id>
    </subscription>