ResourcesAPI documentation

mailkit.email.getstatus

Function mailkit.mailinglist.getstatus is used to get available information about recipient.

API call example:

XML

<?xml version="1.0"?>
<methodCall>
<methodName>mailkit.email.getstatus</methodName>
<params>
    <param>
        <value>
            <int>client_id</int>
        </value>
    </param>
    <param>
        <value>
            <string>client_md5</string>
        </value>
    </param>  
    <param>
        <value>
            <int>email_id</int>
        </value>
    </param>
</params>
</methodCall>

Values

client_id * = client ID can be found in your Mailkit account's menu Profile / Integration / API settings.

client_md5 * = MD5 code can be found in your Mailkit account's menu Profile / Integration / API settings.

email_id * = may contain ID of e-mail address, (returned by mailkit.mailinglist.adduser), or e-mail address. If an email address is provided a list of all found records will be returned.

* required value

Successful call response:

XML

<?xml version="1.0" encoding="utf-8"?>
<methodResponse>
  <params>
    <param>
      <value>
        <array>
          <data>
            <value>
              <struct>
                <member>
                  <name>ID_EMAIL</name>
                  <value>
                    <i4>12345</i4>
                  </value>
                </member>
                <member>
                  <name>EMAIL</name>
                  <value>
                    <string>example@example.cz</string>
                  </value>
                </member>
                <member>
                  <name>ID_MAILING_LIST</name>
                  <value>
                    <i4>12345</i4>
                  </value>
                </member>
                <member>
                  <name>VOCATIVE</name>
                  <value>
                    <string>salutation</string>
                  </value>
                </member>
                <member>
                  <name>PREFIX</name>
                  <value>
                    <string>title</string>
                  </value>
                </member>
                <member>
                  <name>FIRST_NAME</name>
                  <value>
                    <string>first name</string>
                  </value>
                </member>
                <member>
                  <name>LAST_NAME</name>
                  <value>
                    <string>last name</string>
                  </value>
                </member>
                <member>
                  <name>NICK_NAME</name>
                  <value>
                    <string>nick</string>
                  </value>
                </member>
                <member>
                  <name>GENDER</name>
                  <value>
                    <string>F/M</string>
                  </value>
                </member>
                <member>
                  <name>REPLY_TO</name>
                  <value>
                    <string>example2@example2.cz</string>
                  </value>
                </member>
                <member>
                  <name>PHONE</name>
                  <value>
                    <string>12345</string>
                  </value>
                </member>
                <member>
                  <name>FAX</name>
                  <value>
                    <string>12345</string>
                  </value>
                </member>
                <member>
                  <name>MOBILE</name>
                  <value>
                    <string>12345</string>
                  </value>
                </member>
                <member>
                  <name>COMPANY</name>
                  <value>
                    <string>company</string>
                  </value>
                </member>
                <member>
                  <name>STREET</name>
                  <value>
                    <string>address</string>
                  </value>
                </member>
                <member>
                  <name>CITY</name>
                  <value>
                    <string>city</string>
                  </value>
                </member>
                <member>
                  <name>COUNTRY</name>
                  <value>
                    <string>country</string>
                  </value>
                </member>
                <member>
                  <name>ZIP</name>
                  <value>
                    <string>ZIP</string>
                  </value>
                </member>
                <member>
                  <name>STATE</name>
                  <value>
                    <string>state</string>
                  </value>
                </member>
                <member>
                  <name>DATE</name>
                  <value>
                    <string>yyyy-mm-dd hh:mm:ss</string>
                  </value>
                </member>
                <member>
                  <name>STATUS</name>
                  <value>
                    <string>enabled</string>
                  </value>
                </member>
                <member>
                  <name>CUSTOM_1</name>
                  <value>
                    <string>custom field n. 1</string>
                  </value>
                </member>
                <member>
                  <name>CUSTOM_25</name>
                  <value>
                    <string>custom field n. 25</string>
                  </value>
                </member>
              </struct>
            </value>
          </data>
        </array>
      </value>
    </param>
  </params>
</methodResponse>

Values

ID_EMAIL = ID of recipient's e-mail address

EMAIL = e-mail address of recipient

ID_MAILING_LIST = ID of mailing list

VOCATIVE = salutation of recipient

PREFIX = title of recipient

FIRST_NAME = first name of recipient

LAST_NAME = last name of recipient

NICK_NAME = nick of recipient

GENDER = gender of recipient. Possible values:

  • F = female
  • M = male
  • empty field = without gender

REPLY_TO = e-mail address of recipient for reply-to

PHONE = phone of recipient

FAX = fax of recipient

MOBILE = mobile of recipient

COMPANY = company of recipient

STREET = address of recipient

CITY = city of recipient

COUNTRY = country of recipient

ZIP = ZIP of recipient

STATE = state of recipient

DATE = date recipient was added to the list

STATUS = status of recipient. Possible values:

  • enabled
  • disabled
  • unknown
  • temporary
  • permanent
  • unsubscribe

CUSTOM_1 = custom field of recipient n. 1. Total number of custom field is 25.

Unsuccessful call response:

<?xml version="1.0" encoding="utf-8"?>
<methodResponse>
    <params>
        <param>
            <value>
                <string></string>
            </value>
        </param>
    </params>
</methodResponse>

Values

Empty response

  • wrong e-mail ID

and/or

  • wrong e-mail address