Definition

Returns a list of Kulea Events. This list can be filtered against event types and event dates.

REST API URL

Example URL 

Headers

  • Authorization (Mandatory String <API-KEY>) - Example: afeWER£4q3

Query String

The presence of a query string will allow contacts to be filtered accordingly. Some examples are:

  • eventtypes is mandatory and allows filtering against specific event types.  Example eventtype=addedcrm,importedcrm will return all events where the event type is either addedcrm or importedcrm
  • dtfrom and dtto allow you to filter between dates when the events were generated e.g. dtfrom=20170201-133212, will search for all events generated after 01/02/2017 13:32:12.

The list below highlights the different types of filters:

  • eventtypes (Mandatory <eventtype1>,<eventtype2>...) Example: addedcrm,pagevisit
  • dtfrom (Optional String <yyyyMMdd-HHmmss>) - Example: 20170204-130530
  • dtto (Optional String <yyyyMMdd-HHmmss>) - Example: 20170205-130530

NOTE: The eventtypes query string parameter can be anything from the following list of events: pagevisit, genericformcomplete,        emopened, emclickedlink,thirdpartypagevisit, resourcedownload, genericformview, formcomplete,    thirdpartyformcomplete, thirdpartyresourcedownload, buttonclicked, thirdpartybuttonclicked,        thirdpartynewsubscriber, thirdpartynewregistration, newsubscriber, newregistration, formview,        thirdpartyformview, linkclicked, thirdpartylinkclicked, importedcrm, emunsubscribe, addedcrm

Response (application/json)

Response will be a json object with the following fields:

  • success - if true then request was successful; otherwise failed.
  • reason - only shown if success is false and indicates the reason of failure.  Example mandatory eventtypes parameter missing.
  • count - represent total number of events returned
  • events- jsonArray representation of each Kulea event

Example (GET https://{{MA2ID}}.prod.kulea.marketing:8089/rest/api/users?eventtypes=addedcrm):

{
"success": true,
"count": 10,
"events": [
{
"date": "20170629-191335",
"type": "addedcrm",
            "description": "junaid1@kulea.ma",
"crm_id": 4294967657
},
{
"date": "20170629-193828",
"type": "addedcrm",
            "description": "junaid2@kulea.ma",
"crm_id": 4294967658
},
{
"date": "20170629-193909",
"type": "addedcrm",
            "description": "junaid3@kulea.ma",
"crm_id": 4294967659
},
{
"date": "20170629-194004",
"type": "addedcrm",
            "description": "junaid4@kulea.ma",
"crm_id": 4294967660
},
{
"date": "20170629-194301",
"type": "addedcrm",
            "description": "junaid5@kulea.ma",
"crm_id": 4294967661
},
{
"date": "20170701-001905",
"type": "addedcrm",
            "description": "junaid6@kulea.ma",
"crm_id": 4294967662
},
{
"date": "20170701-002001",
"type": "addedcrm",
            "description": "junaid7@kulea.ma",
"crm_id": 4294967663
},
{
"date": "20170701-002135",
"type": "addedcrm",
            "description": "junaid8@kulea.ma",
"crm_id": 4294967664
},
{
"date": "20170725-141901",
"type": "addedcrm",
            "description": "junaid8@kulea.ma",
"crm_id": 4294967667
},
{
"date": "20170726-143431",
"type": "addedcrm",
            "description": "junaid9@kulea.ma",
"crm_id": 4294967668
}
]
}