List Distributions API - Filter Transaction Batches by Mailing List ID | Experience Community
Skip to main content
Question

List Distributions API - Filter Transaction Batches by Mailing List ID

  • January 27, 2026
  • 2 replies
  • 28 views

Forum|alt.badge.img+7

We are using the List Distributions API endpoint to extract distribution history from Qualtrics and load to an internal system. The endpoint supports using a Mailing List ID filter to only include results with distributions that were linked to a specific mailing list. This is being used to only include results from the production directory/mailing list. This works well for individual transaction based distributions where a single contact is sent an invite via a workflow using the “XM Directory” task + “Send a survey via email” task.

 

We also have surveys where they are distributed via an ETL/bulk file load process where the transactions are imported into the directory and distributed to many survey recipients in a single workflow using the “Add contacts and transactions to XMD” task + “Send a survey via email” task. The distributions are in fact linked to a specific mailing list. But for these distributions, the List Distributions API endpoint does not function with the Mailing List ID filter. The response is empty with no distributions. You must remove the filter for the endpoint to return distributions to your specific survey. This causes an issue where we cannot filter to only return distributions sent in the production directory/mailing list.

 

Have others faced this or found a workaround?

2 replies

Forum|alt.badge.img+2
  • Level 2 ●●
  • February 9, 2026

Hi ​@jake_dufinetz , when using ETL workflow with XMD and email task, it works as you are distributing to an individual contact and not to an entire mailing list. So, it will not return any distribution details while filtering it based on mailing list. 

Enter the “distributionRequestType” as email along with the survey id in the list distributions API, which may return the details of survey distributed using email task.


Forum|alt.badge.img+7
  • Author
  • QPN Level 4 ●●●●
  • February 9, 2026

Hi ​@Anushree R - Thanks for the response! Yes, I am able to successfully call the API when removing the mailing list ID and just using distributionRequestType + Survey ID. However it would be very helpful to be able to use the mailing list ID as an additional filter for these distributions.

You mentioned that it doesn’t work due to distributing to an individual contact vs an entire mailing list. However, when distributing to an individual contact transaction within a mailing list, the mailing list ID filter does work. This is why it is surprising that it doesn’t work when sending to a transaction batch within a mailing list.