TEtextmagic
Distribution Lists

Get the details of a specific distribution list

Changed on

<a class="try-sandbox-link" href="https://sandbox.textmagic.com/#/Distribution%20Lists/getDistributionList" target="_blank">Try in sandbox</a><br>

get/api/v2/distribution-lists/{id}

Request

Path parameters

idinteger required

Response

Returned when successful.

idinteger required

Distribution list ID.

namestring required

Distribution list name.

emailstring required

The auto-generated email address. Emails sent here are forwarded as text messages to the list recipients.

membersCountinteger required

Total number of unique recipients (contacts + list members + segment members + numbers, de-duplicated).

includeOptions'body' | 'subject' | 'both' required

Which part of the incoming email is included in the outgoing SMS.

maxLengthinteger required

Maximum number of SMS parts per message (1-6).

Example response

{
  "id": 715,
  "name": "Support alerts",
  "email": "ab12345678@distributionlists.textmagic.com",
  "membersCount": 332,
  "includeOptions": "both",
  "maxLength": 6,
  "recipients": {
    "contactIds": [
      1,
      2
    ],
    "groupIds": [
      3
    ],
    "segmentIds": [
      4,
      5
    ],
    "numbers": [
      "+15551234567"
    ]
  },
  "senderSource": {
    "phone": "+15551234567"
  }
}

Changes