Marketing API | Recipient Lists

Hello,

I have a specific question regarding the Marketing API, which is currently in beta. I’m wondering if it’s possible to export a list of recipients of marketing emails. My ultimate objective is to determine if we would be permitted to query a marketing email and its recipient list to ascertain who received it, such as stating, “X email was sent to person A, B, and C.”

Thank you.

Hey, @cvalverde :waving_hand: Thanks for your question. It sounds like the Email Analytics API is what you are after. There isn’t an updated version yet, but the legacy endpoints listed here are stable and supported:

One workaround might be to leverage the lists tool and then query your list using the Lists API.

Best,

Jaycee

Is there any update here?
I think this can’t be the solution to use many API-Calls to get just a simple information:

Get me all Contacts to an published-E-Mail with the last status (send, open, bounces…)
Just like 1:1 the export file in Excel.

Hey, @MWelter9 Thanks for the follow up.

There is no simple “1:1 export” endpoint. You must build that report yourself using the event data.

  1. Make a GET request to the same GET /email/public/v1/events endpoint, filtering by emailId.
  2. Get all event types (SENT, OPEN, CLICK, BOUNCE, DROPPED, etc.).
  3. You must then process this data to find the latest or most relevant status for each unique contactId or recipientEmail.

Best,

Jaycee

Hi Jaycee,

I appreciate your insights on this matter.

It appears that utilizing the list data and the List API may not fully meet our requirements; it seems to be related to a filter issue. Currently, I’m only able to query the email’s name. Unfortunately, I’m unable to extract or incorporate a time frame or focus on a sent date/time stamp, which is essential for our needs.

We are seeking a solution that enables us to pull and export a marketing email recipient list, complete with a timestamp indicating when it was sent. While I’ve been able to achieve this manually through the process Email > Recipients > List Actions > Export, we’re looking for any of the available API’s to help us achieve this.

Any additional assistance in pointing us in the right direction would be greatly appreciated.

Thank you.