List Distribution Links

GET {{baseUrl}}/distributions/:distributionId/links?skipToken=<string>&surveyId=SV_cHbKMOdeT8NetF3

Return a list of individual distribution links for an existing distribution.

Email Status Always Shows Not Sent

While email status is returned by this call, it will always be set to Email not sent. This call will not show the respondent's progress. This call is strictly meant to return the distribution links created in the Generate Distribution Links call. Running this call on other distributions will reset email status dates to the date the API is run. If you want to get the respondent's progress, use the contactId returned in the result and call Get Contact History. Additional contact information is located in the List Contacts API result. <!-- theme: warning -->

Calling this API will result in the Contact Frequency Rules for a contact to be updated.

Request Params

KeyDatatypeRequiredDescription
skipTokenstring
surveyIdstring(Required) The ID of the survey to which the distribution belongs.

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{&quot;result&quot;:{&quot;elements&quot;:[{&quot;contactId&quot;:&quot;CGC_012345678901234&quot;,&quot;link&quot;:&quot;https://WCIPRtMAE.jkbqNtT1lgv3HvRvKOeOULcwzoGOSMCEYyxOHBo2Psh&quot;,&quot;linkExpiration&quot;:&quot;1987-09-06T11:11:11.718Z&quot;,&quot;lastName&quot;:&quot;eu dolore deserunt Excepteur&quot;,&quot;firstName&quot;:&quot;dolor in&quot;,&quot;externalDataReference&quot;:&quot;exercitat&quot;,&quot;email&quot;:&quot;id&quot;,&quot;unsubscribed&quot;:true,&quot;status&quot;:&quot;sunt&quot;,&quot;exceededContactFrequency&quot;:true},{&quot;contactId&quot;:&quot;CGC_012345678901234&quot;,&quot;link&quot;:&quot;http://VjmvZxkyfuMbKMagTgZPFbomsVIBUAMU.ihc5UR9EkZiPvsRPXOwVDfC,JB7Mf+H-Dp8szP4SvusRaP0Hep5+vb5f,&quot;,&quot;linkExpiration&quot;:&quot;1969-07-27T22:29:12.485Z&quot;,&quot;lastName&quot;:&quot;enim&quot;,&quot;firstName&quot;:&quot;irure nostrud consectetur ad&quot;,&quot;externalDataReference&quot;:&quot;non elit&quot;,&quot;email&quot;:&quot;reprehenderit ipsum cillum consectetur occaecat&quot;,&quot;unsubscribed&quot;:true,&quot;status&quot;:&quot;et veniam nostrud Lorem est&quot;,&quot;exceededContactFrequency&quot;:true}],&quot;nextPage&quot;:&quot;sint adipisicing Excepteur&quot;},&quot;meta&quot;:{&quot;httpStatus&quot;:&quot;laborum labore minim&quot;,&quot;requestId&quot;:&quot;Ut ipsum nostrud&quot;,&quot;notice&quot;:&quot;in esse cupidatat Ut&quot;}}