Product Updates New VerticalResponse API Features

Published on July 16th, 2014 | by Jennifer Sherwood

2

New VerticalResponse API Features!

One of our goals in creating the new VerticalResponse is to have a powerful API, and our latest release brings tons of new goodies in that area. We are constantly working to make the VR REST API very intuitive and robust, and believe we’re hitting the mark with these features:

Detailed Stats APIs

In our previous release, we focused on bringing you analytics APIs providing summary level stats. We promised you we’d be back with more stats APIs, and here we are!

Our Email: Summary Stats API provides overall stats on the number of opens, unsubscribes and bounces for a particular email. However with our new detailed stats, we provide details about which specific contacts opened, unsubscribed, bounced and clicked on specific links in an email. The detailed stats APIs are:

Email

Emails: Opens

This API will list all the contacts that opened a particular email. Depending on the type parameter (basic, standard or all), attributes of contacts are returned.

Sample Request

 

Sample Response

 

Emails:Unsubscribes

This API will list all the contacts that unsubscribed from a given email. Depending on the type parameter (basic, standard or all), attributes of contacts are returned.

Sample Request

 

Sample Response

 

Email:Bounces

This API will list all the contacts that bounced from a given email. Depending on the type parameter (basic, standard or all), attributes of contacts are returned. The contacts returned have been hard bounced only – VR does not return contacts that have a soft bounce status.

There are two types of bounces

Hard Bounce: A permanent delivery issue like a non-existent email address.

Soft Bounce:  A temporary delivery issue like a full mailbox or technical issue.

Sample Request

 

Sample Response

 

Contacts

Returning Status attribute in all Contacts GET APIs

Now, every time a contact list API, Search or a Read API is called, the contact’s status will be returned, regardless of the type parameter. This way it’s easy to know whether a contact is mailable, bounced or unsubscribed.

List Active Contacts

Just like the ability to list inactive contacts, you can now also retrieve a list of all active contacts. Active contacts are mailable contacts, i.e. those who will receive an email campaign that you send out using VerticalResponse. Active contacts determine the reach of a particular mailing list.

Sample Request

 

Sample Response

 

OAuth

Now when obtaining an access token, you can also receive the user_id associated with the access token. This is the VR user id of the VerticalResponse user who has given your application access to their VR account.

Sample Response

 

We continue to work on new and exciting updates, and can’t wait to share it with you all soon. Until then, happy coding!

© 2014 – 2015, Jennifer Sherwood. All rights reserved.

Read Next:

Tags: , , ,


About the Author

Jennifer Sherwood

is the Director of Product Marketing at VerticalResponse.



2 Responses to New VerticalResponse API Features!

  1. Jill Bastian Jill Bastian says:

    Hi Nick,

    API is Application Programming Interface and basically lets two different software programs link up to share some data. If you have your Facebook account linked in VR so you can share posts, that uses an api to link the two together. We released a new api not too long ago and we’ve now added some more features to it.

    Jill Bastian
    Training and Education Manager
    VerticalResponse

  2. Nick Nicolaas says:

    I use VR. But, what does API stand for?

Leave a Reply

Your email address will not be published. Required fields are marked *

Back to Top ↑