Skip to content
/
Get Multiple Contacts

Get Multiple Contacts

Request

Returns the complete data of up to 500 contacts.

Path
subscriberidsstring^[1-9][0-9]*(,[1-9][0-9]*){0,499}$required

Comma-separated list of numeric contact IDs.

Example:123,456
curl -i -X GET \
  'https://api.klicktipp.com/subscriber/bulk/123,456'

Responses

Success Response.

Bodyapplication/json
property name*(SubscriberDetailSchema (object or null))additional property
One of:

Legacy subscriber detail representation. Field formats and semantics are not fully normalized.

Response
{
  "property1": {
    "id": "987654321",
    "email": "alex.example@klicktipp.example",
    "status": "Subscribed",
    "bounce": "Not Bounced",
    "listid": "12345",
    "optin": "01.01.2025 12:00:00",
    "optin_ip": "0.0.0.0",
    "date": "01.01.2025 13:00:00",
    "ip": "0.0.0.0",
    "unsubscription": "",
    "unsubscription_ip": "",
    "referrer": "https://integration.example.com/webhooks/payment/ipn",
    "sms_phone": "00491701234567",
    "sms_status": "Subscribed",
    "sms_bounce": "Not Bounced",
    "sms_date": "01.02.2025 12:00:00",
    "sms_unsubscription": "",
    "sms_referrer": "https://signup.example.com/sms-form",
    "fieldFirstName": "Alex",
    "fieldLastName": "Example",
    "fieldCompanyName": "Example Corp",
    "fieldStreet1": "Example Street 1",
    "fieldStreet2": "",
    "fieldCity": "Berlin",
    "fieldState": "Berlin",
    "fieldZip": "10115",
    "fieldCountry": "DE",
    "fieldPrivatePhone": "00491701234567",
    "fieldMobilePhone": "00491707654321",
    "fieldPhone": "00492207654321",
    "fieldFax": "00492201234567",
    "fieldWebsite": "https://www.klicktipp.example",
    "fieldBirthday": "755222400",
    "fieldLeadValue": "100",
    "tags": [ … ],
    "smart_tags": { … },
    "manual_tags": { … },
    "notification_emails_sent": { … },
    "notification_emails_opened": { … },
    "notification_emails_clicked": { … },
    "emails_sent": { … },
    "emails_opened": { … },
    "emails_clicked": { … },
    "campaigns_started": { … },
    "campaigns_finished": { … }
  },
  "property2": {
    "id": "987654321",
    "email": "alex.example@klicktipp.example",
    "status": "Subscribed",
    "bounce": "Not Bounced",
    "listid": "12345",
    "optin": "01.01.2025 12:00:00",
    "optin_ip": "0.0.0.0",
    "date": "01.01.2025 13:00:00",
    "ip": "0.0.0.0",
    "unsubscription": "",
    "unsubscription_ip": "",
    "referrer": "https://integration.example.com/webhooks/payment/ipn",
    "sms_phone": "00491701234567",
    "sms_status": "Subscribed",
    "sms_bounce": "Not Bounced",
    "sms_date": "01.02.2025 12:00:00",
    "sms_unsubscription": "",
    "sms_referrer": "https://signup.example.com/sms-form",
    "fieldFirstName": "Alex",
    "fieldLastName": "Example",
    "fieldCompanyName": "Example Corp",
    "fieldStreet1": "Example Street 1",
    "fieldStreet2": "",
    "fieldCity": "Berlin",
    "fieldState": "Berlin",
    "fieldZip": "10115",
    "fieldCountry": "DE",
    "fieldPrivatePhone": "00491701234567",
    "fieldMobilePhone": "00491707654321",
    "fieldPhone": "00492207654321",
    "fieldFax": "00492201234567",
    "fieldWebsite": "https://www.klicktipp.example",
    "fieldBirthday": "755222400",
    "fieldLeadValue": "100",
    "tags": [ … ],
    "smart_tags": { … },
    "manual_tags": { … },
    "notification_emails_sent": { … },
    "notification_emails_opened": { … },
    "notification_emails_clicked": { … },
    "emails_sent": { … },
    "emails_opened": { … },
    "emails_clicked": { … },
    "campaigns_started": { … },
    "campaigns_finished": { … }
  }
}