List Contacts In Mailing List

GET {{baseUrl}}/directories/:directoryId/mailinglists/:mailingListId/contacts?pageSize=50&skipToken=<string>&includeEmbedded=<boolean>

Return a list of contacts in a specified mailing list. <!--From Readme--> For the last page of results, the value associated with nextPage will be null. <!-- theme: warning -->

This API call is only available to XM Directory users.

The maximum value for pageSize is 50.

The new string-based pagination functionality results in improved performance and a lower rate of timeouts. To opt in, append query parameter useNewPaginationScheme=true.

Request Params

KeyDatatypeRequiredDescription
pageSizenumberThe maximum number of items to return per request
skipTokenstringThe start position for pagination
includeEmbeddedstringWhether embeddedData is returned in the response.

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{&quot;result&quot;:{&quot;elements&quot;:[{&quot;contactId&quot;:&quot;\u003cstring\u003e&quot;,&quot;firstName&quot;:&quot;\u003cstring\u003e&quot;,&quot;lastName&quot;:&quot;\u003cstring\u003e&quot;,&quot;email&quot;:&quot;\u003cstring\u003e&quot;,&quot;phone&quot;:&quot;\u003cstring\u003e&quot;,&quot;extRef&quot;:&quot;\u003cstring\u003e&quot;,&quot;language&quot;:&quot;\u003cstring\u003e&quot;,&quot;unsubscribed&quot;:&quot;\u003cboolean\u003e&quot;,&quot;embeddedData&quot;:{&quot;eu686&quot;:&quot;dolor minim incididunt&quot;}},{&quot;contactId&quot;:&quot;\u003cstring\u003e&quot;,&quot;firstName&quot;:&quot;\u003cstring\u003e&quot;,&quot;lastName&quot;:&quot;\u003cstring\u003e&quot;,&quot;email&quot;:&quot;\u003cstring\u003e&quot;,&quot;phone&quot;:&quot;\u003cstring\u003e&quot;,&quot;extRef&quot;:&quot;\u003cstring\u003e&quot;,&quot;language&quot;:&quot;\u003cstring\u003e&quot;,&quot;unsubscribed&quot;:&quot;\u003cboolean\u003e&quot;,&quot;embeddedData&quot;:{&quot;ex_9&quot;:&quot;sit in nulla&quot;,&quot;esse2&quot;:&quot;consectet&quot;}}],&quot;nextPage&quot;:&quot;\u003cstring\u003e&quot;},&quot;meta&quot;:{&quot;httpStatus&quot;:&quot;\u003cstring\u003e&quot;,&quot;requestId&quot;:&quot;\u003cstring\u003e&quot;,&quot;notice&quot;:&quot;\u003cstring\u003e&quot;}}