In diesem Abschnitt:

Querying Contact Data from a Contact List

Es tut uns leid, aber diese Seite wurde leider noch nicht übersetzt. Doch keine Sorge, das Emarsys Lokalisierungsteam arbeitet eifrig daran, unsere gesamte Dokumentation in Ihrer Sprache bereitzustellen.

Queries the data of selected contacts from a contact list.

Endpoint

GET https://api.emarsys.net/api/v2/contactlist/<675738479>/contacts/data

Parameters

Required parameters

Name Type Description Comments
contact_list_id int ID of the contact list, part of the URI.  
contact_fields mixed Number ID or name of the fields. Values should be delimited by comma (e.g.: "1,2,3" or "email,first_name", etc.).

Optional parameters

Name Type Description Comments
limit int The number of contacts to be queried, part of the URI.  
offset int The number in the contact list where the query should start, part of the URI.  

URI Examples

https://api.emarsys.net/api/v2/contactlist/<675738479>/contacts/data/?fields=3

https://api.emarsys.net/api/v2/contactlist/<675738479>/contacts/data/?offset=50&limit=100&fields=3

Result Example

{{
  "replyCode": 0,
  "replyText": "OK",
  "data": {
    "144143017": {
      "fields": {
        "3": "bruce.wayne@superhero.com",
        "id": "144143017",
        "uid": "Irre5miLj9"
      }
    },
    "927578501": {
      "fields": {
        "3": "peter.parker@superhero.com",
        "id": "927578501",
        "uid": "0Xdb29tQkB"
      }
    }
  }
}

Errors

HTTP Code Reply Code Message Description
400 3007 Contact fields value is not set. Contact fields value is required, please set a field ID or a field name.
404 3006 No contact list found with the specified ID. Please specify a valid contact list ID.