Get domain mailing lists

This request is used for getting all the domain's mailing lists.

  1. Request syntax
  2. Request example
  3. Response structure

Request syntax

The request should be sent over the HTTPS protocol using the GET method.

GET /api2/admin/email/ml/list?
domain=<domain name>

Host: pddimp.yandex.ru
PddToken: <PDD token>

Headers:

Name Description
PddToken

PDD token.
Name Description
PddToken

PDD token.

Parameters:

Parameter Type Value
Mandatory
domain String

Name of the domain.
Parameter Type Value
Mandatory
domain String

Name of the domain.

Request example

GET /api2/admin/email/ml/list?domain=domain.com HTTP/1.1
Host: pddimp.yandex.ru
PddToken: 123456789ABCDEF0000000000000000000000000000000000000
cURL
curl -H 'PddToken: 123456789ABCDEF0000000000000000000000000000000000000' 'https://pddimp.yandex.ru/api2/admin/email/ml/list?domain=domain.com'

Response structure

{
  "domain": "{domain name}",
  "maillists":
  [
    {
      "maillist": "{mailing list address}",
      "uid": "{mailing list ID}",
      "cnt": "{number of subscribers}"
    },
    ...
  ],
  "success": "{status of request execution}"
}
Name Type of value Description
domain String

Name of the domain.
success String

Status of request execution.

Possible values:
  • ok — Request executed successfully.
  • error — Request executed with error.
error String

Error code.

Included in the response if the request resulted in an error.

Possible values:
  • unknown — A temporary failure or API error occurred (repeat the request again later).
  • no_token (no_domain, no_ip ) — A mandatory parameter was omitted.
  • bad_domain — The domain name was not specified or does not conform to the RFC.
  • prohibited — A forbidden domain name.
  • bad_token (bad_login, bad_passwd) — An invalid PDD token (or username/password) was passed.
  • no_auth — The PddToken header was omitted.
  • not_allowed — This operation is not allowed for this user (the user is not the domain administrator).
  • blocked — Blocked domain (for example, due to spam and so on).
  • occupied — The domain name is in use by another user.
  • domain_limit_reached — Exceeded the acceptable number of connected domains (50).
  • no_reply — Yandex.Mail for Domain cannot connect to the server source for the import.
maillists Array

Properties of mailing lists. Each object in the array corresponds to a single mailing list.
Keys for objects in the maillists array
maillist String

Email address of the mailing list.
uid Integer

ID of the mailing list.
cnt Integer

Number of subscribers to the mailing list.
Name Type of value Description
domain String

Name of the domain.
success String

Status of request execution.

Possible values:
  • ok — Request executed successfully.
  • error — Request executed with error.
error String

Error code.

Included in the response if the request resulted in an error.

Possible values:
  • unknown — A temporary failure or API error occurred (repeat the request again later).
  • no_token (no_domain, no_ip ) — A mandatory parameter was omitted.
  • bad_domain — The domain name was not specified or does not conform to the RFC.
  • prohibited — A forbidden domain name.
  • bad_token (bad_login, bad_passwd) — An invalid PDD token (or username/password) was passed.
  • no_auth — The PddToken header was omitted.
  • not_allowed — This operation is not allowed for this user (the user is not the domain administrator).
  • blocked — Blocked domain (for example, due to spam and so on).
  • occupied — The domain name is in use by another user.
  • domain_limit_reached — Exceeded the acceptable number of connected domains (50).
  • no_reply — Yandex.Mail for Domain cannot connect to the server source for the import.
maillists Array

Properties of mailing lists. Each object in the array corresponds to a single mailing list.
Keys for objects in the maillists array
maillist String

Email address of the mailing list.
uid Integer

ID of the mailing list.
cnt Integer

Number of subscribers to the mailing list.