GET /messaging/v1/email/seed-lists/{id}

Overview 

Read a single seed list for an account. The MID and partner appId is used from authentication. Ensure the MID is activated for MCSeedList. This query verifies that the seed-list GUID given as the value for id belongs to the appID. If so, it returns the active seed-list for the id.

Response 

StatusNameType  Description
200    Successful response indicating the request passed validations
 idstring  The globally unique id (GUID) assigned inception.
 namestring  The description given at creation or update.
 descriptionstring  The description of the seed-list given at creation or update.
 seedslist of objects  The objects in the list each consist of a single name:value pair.
   NameType 
   emailstringAn email address.
200    Successful response but with an empty object, indicating no active seed-lists for the partner appID.

Validation Failure Scenarios 

HTTP StatusDescription
401Seed-list doesn’t belong to the partner appID.
429API rate limit throttling is preventing success.

Usage 

Example Request 

1GET /messaging/v1/email/seed-lists/{id}

Example Responses 

Data exists:

1200 OK
2{
3    "id": "fb9a8b12-a088-4999-b9ce-f8cd3fe06386",
4    "name": "seedList1Name",
5    "description": "Seed list description",
6    "seeds": [
7        {"email": "address1@example.com"},
8        {"email": "address2@example.com"},
9        {"email": "address3@example.com"}
10    ]
11}

No data exists:

1200 OK
2{}

Related Items 

DID THIS ARTICLE SOLVE YOUR ISSUE?
Let us know so we can improve!