Events
The Events endpoint allows you to retrieve all the Contact's location events and application events from your Cloud4Wi account.
List of Events:
"signup": a Contact is created in your Cloud4Wi account, either when a person signs up from the guest WiFi, a Kiosk or via APIs
"visit": a Contact leaves a location after a visit. The event includes the visit metadata such as location and durations
"login": a Contact authenticates to a WiFi network, either on the guest WiFi, WPA2-Enterprise or Passpoint
"promo": a Contact clicks on a call to action in the Promo Page interstitial content. See Promo Page documentation.
"survey": a Contact responds to a survey. See Survey documentation
"send_email": an email has been sent via Campaign
"open_email": an email sent via Campaign has been opened
"click_email": a trackable link of an email sent via Campaign has been clicked
"send_sms": an SMS has been sent via Campaign
"click_sms": a trackable link of an SMS sent via Campaign has been clicked
Endpoints
List all Events, including Visits, WiFi connections and application events, of an Organization Retrieve all events og of the given organization . Role: Organization Manager Scope: organization_read, events_read
Authorizations
Path parameters
cidstringRequired
id of the organization (aka tenant)
Query parameters
dateStartstringOptional
Return events with date >= of request. Format is date iso8601. Eg: 2019-07-31T22:23:24Z
dateEndstringOptional
Return events with date <= of request. Format is date iso8601. Eg: 2019-07-31T22:23:24Z
eventsstringOptional
List of events (comma separated). Possible values: visit,signup, login, send_email,open_email,click_email,send_sms,click_sms,survey, promo
sizestringOptional
Number of events returned by the request. Allowed values between 1 and 10000. It is not possible to change this values during a scrolling.
sortBystringOptional
Sort list by: businessTime, utcTime (default is businessTime)
sortReversebooleanOptional
Reverse sort order
enableScrollbooleanOptional
Enable scroll. If true, the response will contain a scrollId. Use it to get the next page of results.
scrollIdbooleanOptional
Scroll id. Use it to get the next page of results.
Responses
200
Response
application/json
default
Error
application/json
get
GET //v1/organizations/{cid}/events HTTP/1.1
Host: explore.cloud4wi.com
Authorization: Bearer JWT
Accept: */*
{
"status": "text",
"generated": "text",
"count": 1,
"events": [
{
"type": "text",
"id": "text",
"visit": {
"startAt": "text",
"startAtLocal": "text",
"timezone": "text",
"duration": 1
},
"signup": {
"source": "text"
},
"email": {
"campaignId": "text",
"communicationId": "text",
"channel": "text",
"campaignName": "text",
"email": "text"
},
"sms": {
"campaignId": "text",
"communicationId": "text",
"channel": "text",
"campaignName": "text",
"phone": "text",
"prefix": "text"
},
"survey": {
"campaignId": "text",
"campaignName": "text",
"answerId": "text",
"questions": {
"question_1": "text"
},
"answers": {
"answer_1": "text"
}
},
"promo": {
"type": "text"
}
}
]
}List all events, including WiFi Connections, Visits and applicaiton events of a given Contact Id Role: Organization Manager Scope: organization_read, events_read
Authorizations
Path parameters
cidstringRequired
id of the organization (aka tenant)
idstringRequired
id of the user (ID of the table w.USERS) passed inside the JWT received at login
Query parameters
dateStartstringOptional
Return events with date >= of request. Format is date iso8601. Eg: 2019-07-31T22:23:24Z
dateEndstringOptional
Return events with date <= of request. Format is date iso8601. Eg: 2019-07-31T22:23:24Z
eventsstringOptional
List of events (comma separated). Possible values: visit,signup, login, send_email,open_email,click_email,send_sms,click_sms,survey, promo
sizestringOptional
Number of events returned by the request. Allowed values between 1 and 10000. It is not possible to change this values during a scrolling.
sortBystringOptional
Sort list by: businessTime, utcTime (default is businessTime)
sortReversebooleanOptional
Reverse sort order
Responses
200
Response
application/json
default
Error
application/json
get
GET //v1/organizations/{cid}/customers/{id}/events HTTP/1.1
Host: explore.cloud4wi.com
Authorization: Bearer JWT
Accept: */*
{
"status": "text",
"generated": "text",
"count": 1,
"events": [
{
"type": "text",
"id": "text",
"visit": {
"startAt": "text",
"startAtLocal": "text",
"timezone": "text",
"duration": 1
},
"signup": {
"source": "text"
},
"email": {
"campaignId": "text",
"communicationId": "text",
"channel": "text",
"campaignName": "text",
"email": "text"
},
"sms": {
"campaignId": "text",
"communicationId": "text",
"channel": "text",
"campaignName": "text",
"phone": "text",
"prefix": "text"
},
"survey": {
"campaignId": "text",
"campaignName": "text",
"answerId": "text",
"questions": {
"question_1": "text"
},
"answers": {
"answer_1": "text"
}
},
"promo": {
"type": "text"
}
}
]
}Data example
Example of the response of the endpoint https://explore.cloud4wi.com//v1/organizations/{cid}/events
{
"generated": "2022-11-15T15:50:54Z",
"count": 20,
"events": [
{
"organizationId": "155d60f21dc1938562900a0e201d54f6",
"customerId": "f4c6be2cebc56bf4b8a16a2d463d5b60",
"event": {
"type": "arriving",
"id": "bd849965350413bc81e19aa5ff1be7ebl"
},
"where": {
"locationId": "ff808081803ff92a01821d4cfd856805",
"locationName": "Ivan Home",
"hotspotId": "5da63f1da1f3a290306314b6273d6382"
},
"when": {
"createdAt": "2022-07-21T18:41:09Z",
"createdAtLocal": "2022-07-21T11:41:09Z",
"timezone": "America/Los_Angeles"
}
},
{
"organizationId": "155d60f21dc1938562900a0e201d54f6",
"customerId": "f4c6be2cebc56bf4b8a16a2d463d5b60",
"event": {
"type": "login",
"id": "9e6391ce506c7ee7eb4c689b622feed3l"
},
"where": {
"locationId": "ff808081803ff92a01821d4cfd856805",
"locationName": "Ivan Home",
"hotspotId": "5da63f1da1f3a290306314b6273d6382"
},
"when": {
"createdAt": "2022-07-21T18:41:09Z",
"createdAtLocal": "2022-07-21T11:41:09Z",
"timezone": "America/Los_Angeles"
}
},
{
"organizationId": "155d60f21dc1938562900a0e201d54f6",
"customerId": "f4c6be2cebc56bf4b8a16a2d463d5b60",
"event": {
"type": "login",
"id": "a419b0bef205cb25a7615011ecf72940l"
},
"where": {
"locationId": "ff808081803ff92a01821d4cfd856805",
"locationName": "Ivan Home",
"hotspotId": "5da63f1da1f3a290306314b6273d6382"
},
"when": {
"createdAt": "2022-07-21T18:41:30Z",
"createdAtLocal": "2022-07-21T11:41:30Z",
"timezone": "America/Los_Angeles"
}
},
{
"organizationId": "155d60f21dc1938562900a0e201d54f6",
"customerId": "f4c6be2cebc56bf4b8a16a2d463d5b60",
"event": {
"type": "login",
"id": "de2d683824f367234fe7734a4246cd32l"
},
"where": {
"locationId": "ff808081803ff92a01821d4cfd856805",
"locationName": "Ivan Home",
"hotspotId": "5da63f1da1f3a290306314b6273d6382"
},
"when": {
"createdAt": "2022-07-21T18:53:49Z",
"createdAtLocal": "2022-07-21T11:53:49Z",
"timezone": "America/Los_Angeles"
}
},
{
"organizationId": "155d60f21dc1938562900a0e201d54f6",
"customerId": "f4c6be2cebc56bf4b8a16a2d463d5b60",
"event": {
"type": "login",
"id": "4578cad147be31ceb6c5417f5439f8b2l"
},
"where": {
"locationId": "ff808081803ff92a01821d4cfd856805",
"locationName": "Ivan Home",
"hotspotId": "5da63f1da1f3a290306314b6273d6382"
},
"when": {
"createdAt": "2022-07-21T18:53:49Z",
"createdAtLocal": "2022-07-21T11:53:49Z",
"timezone": "America/Los_Angeles"
}
},
{
"organizationId": "155d60f21dc1938562900a0e201d54f6",
"customerId": "f4c6be2cebc56bf4b8a16a2d463d5b60",
"event": {
"type": "visit",
"id": "de8a7434d907e640cf1e80c347a420bel",
"visit": {
"startAt": "2022-07-21T18:41:09Z",
"startAtLocal": "2022-07-21T11:41:09Z",
"timezone": "America/Los_Angeles",
"duration": 15
}
},
"where": {
"locationId": "ff808081803ff92a01821d4cfd856805",
"locationName": "Ivan Home"
},
"when": {
"createdAt": "2022-07-21T18:56:23Z",
"createdAtLocal": "2022-07-21T11:56:23Z",
"timezone": "America/Los_Angeles"
}
},
{
"organizationId": "155d60f21dc1938562900a0e201d54f6",
"customerId": "f4c6be2cebc56bf4b8a16a2d463d5b60",
"event": {
"type": "arriving",
"id": "998ce4b66e5de87acf2241876f5dec52l"
},
"where": {
"locationId": "ff808081803ff92a01821d4cfd856805",
"locationName": "Ivan Home",
"hotspotId": "5da63f1da1f3a290306314b6273d6382"
},
"when": {
"createdAt": "2022-07-21T19:52:38Z",
"createdAtLocal": "2022-07-21T12:52:38Z",
"timezone": "America/Los_Angeles"
}
},
{
"organizationId": "155d60f21dc1938562900a0e201d54f6",
"customerId": "f4c6be2cebc56bf4b8a16a2d463d5b60",
"event": {
"type": "login",
"id": "4bd9bbe6e3e084adee2ffe73c88bd10fl"
},
"where": {
"locationId": "ff808081803ff92a01821d4cfd856805",
"locationName": "Ivan Home",
"hotspotId": "5da63f1da1f3a290306314b6273d6382"
},
"when": {
"createdAt": "2022-07-21T19:52:38Z",
"createdAtLocal": "2022-07-21T12:52:38Z",
"timezone": "America/Los_Angeles"
}
},
{
"organizationId": "155d60f21dc1938562900a0e201d54f6",
"customerId": "f4c6be2cebc56bf4b8a16a2d463d5b60",
"event": {
"type": "login",
"id": "972c9bc632809246f7a3e03dfbbf83f7l"
},
"where": {
"locationId": "ff808081803ff92a01821d4cfd856805",
"locationName": "Ivan Home",
"hotspotId": "5da63f1da1f3a290306314b6273d6382"
},
"when": {
"createdAt": "2022-07-21T22:56:42Z",
"createdAtLocal": "2022-07-21T15:56:42Z",
"timezone": "America/Los_Angeles"
}
},
{
"organizationId": "155d60f21dc1938562900a0e201d54f6",
"customerId": "f4c6be2cebc56bf4b8a16a2d463d5b60",
"event": {
"type": "login",
"id": "486e6dd99a9baf7528f9635ccc14a2b3l"
},
"where": {
"locationId": "ff808081803ff92a01821d4cfd856805",
"locationName": "Ivan Home",
"hotspotId": "5da63f1da1f3a290306314b6273d6382"
},
"when": {
"createdAt": "2022-07-21T23:06:15Z",
"createdAtLocal": "2022-07-21T16:06:15Z",
"timezone": "America/Los_Angeles"
}
},
{
"organizationId": "155d60f21dc1938562900a0e201d54f6",
"customerId": "f4c6be2cebc56bf4b8a16a2d463d5b60",
"event": {
"type": "signup",
"id": "05ef4b6d8f936b36ce0c3f71c40494cdl",
"signup": {
"source": "wifi"
}
},
"where": {
"locationId": "ff808081803ff92a01821d4cfd856805",
"locationName": "Ivan Home",
"hotspotId": "5da63f1da1f3a290306314b6273d6382"
},
"when": {
"createdAt": "2022-06-15T11:10:13Z",
"createdAtLocal": "2022-06-15T13:10:13Z",
"timezone": "America/Los_Angeles"
}
},
{
"customerId": "8e62ca2305981e75854dcba1b6491bf5",
"event": {
"type": "geo_visit",
"id": "85bf512b7ff0466143dfbdd1ad0cdefdg",
"visit": {
"startAt": "2022-10-04T15:37:24Z",
"startAtLocal": "2022-10-04T17:37:24Z",
"timezone": "Europe/Rome",
"duration": 0,
"properties": {
"appId": "62d86f755d146f00012297ea",
"appBundle": "com.cloud4wi.toolkit",
"projectId": "62d86f0068c4fc0001c4d63f",
"appOs": "android"
}
}
},
"where": {
"geofenceName": "Emi home",
"geofenceMetadata": [],
"geofenceId": "968bb2b8184f46af916e27aa619791f2",
"geofenceExtId": "Emilia",
"geofenceJSON": {
"type": "Circle",
"coordinates": [
10.517064,
43.675929
],
"radius": 100
}
},
"when": {
"createdAt": "2022-10-04T15:37:39Z",
"createdAtLocal": "2022-10-04T17:37:39Z",
"timezone": "Europe/Rome"
}
},
{
"customerId": "8e62ca2305981e75854dcba1b6491bf5",
"event": {
"type": "geo_arriving",
"id": "9b534ae5c33e6bfc25b1ad768c979384g",
"visit": {
"startAt": "2022-10-04T15:42:49Z",
"startAtLocal": "2022-10-04T17:42:49Z",
"timezone": "Europe/Rome",
"properties": {
"appId": "62d86f755d146f00012297ea",
"appBundle": "com.cloud4wi.toolkit",
"projectId": "62d86f0068c4fc0001c4d63f",
"appOs": "android"
}
}
},
"where": {
"geofenceName": "Emi home",
"geofenceMetadata": [],
"geofenceId": "968bb2b8184f46af916e27aa619791f2",
"geofenceExtId": "Emilia",
"geofenceJSON": {
"type": "Circle",
"coordinates": [
10.517064,
43.675929
],
"radius": 100
}
},
"when": {
"createdAt": "2022-10-04T15:42:49Z",
"createdAtLocal": "2022-10-04T17:42:49Z",
"timezone": "Europe/Rome"
}
},
{
"customerId": "8e62ca2305981e75854dcba1b6491bf5",
"event": {
"type": "geo_visit",
"id": "e0679cb0c6e3bc2aac64b0639cc9b967g",
"visit": {
"startAt": "2022-10-04T15:42:49Z",
"startAtLocal": "2022-10-04T17:42:49Z",
"timezone": "Europe/Rome",
"duration": 0,
"properties": {
"appId": "62d86f755d146f00012297ea",
"appBundle": "com.cloud4wi.toolkit",
"projectId": "62d86f0068c4fc0001c4d63f",
"appOs": "android"
}
}
},
"where": {
"geofenceName": "Emi home",
"geofenceMetadata": [],
"geofenceId": "968bb2b8184f46af916e27aa619791f2",
"geofenceExtId": "Emilia",
"geofenceJSON": {
"type": "Circle",
"coordinates": [
10.517064,
43.675929
],
"radius": 100
}
},
"when": {
"createdAt": "2022-10-04T15:43:25Z",
"createdAtLocal": "2022-10-04T17:43:25Z",
"timezone": "Europe/Rome"
}
},
{
"customerId": "8e62ca2305981e75854dcba1b6491bf5",
"event": {
"type": "geo_arriving",
"id": "8634d19a67f96d95d6154d31ea18effbg",
"visit": {
"startAt": "2022-10-04T15:43:41Z",
"startAtLocal": "2022-10-04T17:43:41Z",
"timezone": "Europe/Rome",
"properties": {
"appId": "62d86f755d146f00012297ea",
"appBundle": "com.cloud4wi.toolkit",
"projectId": "62d86f0068c4fc0001c4d63f",
"appOs": "android"
}
}
},
"where": {
"geofenceName": "Emi home",
"geofenceMetadata": [],
"geofenceId": "968bb2b8184f46af916e27aa619791f2",
"geofenceExtId": "Emilia",
"geofenceJSON": {
"type": "Circle",
"coordinates": [
10.517064,
43.675929
],
"radius": 100
}
},
"when": {
"createdAt": "2022-10-04T15:43:41Z",
"createdAtLocal": "2022-10-04T17:43:41Z",
"timezone": "Europe/Rome"
}
},
{
"customerId": "8e62ca2305981e75854dcba1b6491bf5",
"event": {
"type": "geo_visit",
"id": "200cf048d1386556ab29c0ba119cc3f5g",
"visit": {
"startAt": "2022-10-04T15:43:41Z",
"startAtLocal": "2022-10-04T17:43:41Z",
"timezone": "Europe/Rome",
"duration": 85,
"properties": {
"appId": "62d86f755d146f00012297ea",
"appBundle": "com.cloud4wi.toolkit",
"projectId": "62d86f0068c4fc0001c4d63f",
"appOs": "android"
}
}
},
"where": {
"geofenceName": "Emi home",
"geofenceMetadata": [],
"geofenceId": "968bb2b8184f46af916e27aa619791f2",
"geofenceExtId": "Emilia",
"geofenceJSON": {
"type": "Circle",
"coordinates": [
10.517064,
43.675929
],
"radius": 100
}
},
"when": {
"createdAt": "2022-10-04T17:09:10Z",
"createdAtLocal": "2022-10-04T19:09:10Z",
"timezone": "Europe/Rome"
}
},
{
"customerId": "8e62ca2305981e75854dcba1b6491bf5",
"event": {
"type": "geo_arriving",
"id": "24335a5ae56255b68bb68a34f90d6cb6g",
"visit": {
"startAt": "2022-10-04T18:48:41Z",
"startAtLocal": "2022-10-04T20:48:41Z",
"timezone": "Europe/Rome",
"properties": {
"appId": "62d86f755d146f00012297ea",
"appBundle": "com.cloud4wi.toolkit",
"projectId": "62d86f0068c4fc0001c4d63f",
"appOs": "android"
}
}
},
"where": {
"geofenceName": "Emi home",
"geofenceMetadata": [],
"geofenceId": "968bb2b8184f46af916e27aa619791f2",
"geofenceExtId": "Emilia",
"geofenceJSON": {
"type": "Circle",
"coordinates": [
10.517064,
43.675929
],
"radius": 100
}
},
"when": {
"createdAt": "2022-10-04T18:48:41Z",
"createdAtLocal": "2022-10-04T20:48:41Z",
"timezone": "Europe/Rome"
}
},
{
"customerId": "8e62ca2305981e75854dcba1b6491bf5",
"event": {
"type": "geo_visit",
"id": "e2b34225b2572f19d818094fa48de580g",
"visit": {
"startAt": "2022-10-04T18:48:41Z",
"startAtLocal": "2022-10-04T20:48:41Z",
"timezone": "Europe/Rome",
"duration": 659,
"properties": {
"appId": "62d86f755d146f00012297ea",
"appBundle": "com.cloud4wi.toolkit",
"projectId": "62d86f0068c4fc0001c4d63f",
"appOs": "android"
}
}
},
"where": {
"geofenceName": "Emi home",
"geofenceMetadata": [],
"geofenceId": "968bb2b8184f46af916e27aa619791f2",
"geofenceExtId": "Emilia",
"geofenceJSON": {
"type": "Circle",
"coordinates": [
10.517064,
43.675929
],
"radius": 100
}
},
"when": {
"createdAt": "2022-10-05T05:47:59Z",
"createdAtLocal": "2022-10-05T07:47:59Z",
"timezone": "Europe/Rome"
}
},
{
"customerId": "8e62ca2305981e75854dcba1b6491bf5",
"event": {
"type": "geo_arriving",
"id": "95e3124a20b3b1d5a7380af3b53fa212g",
"visit": {
"startAt": "2022-10-05T07:27:26Z",
"startAtLocal": "2022-10-05T09:27:26Z",
"timezone": "Europe/Rome",
"properties": {
"appId": "62d86f755d146f00012297ea",
"appBundle": "com.cloud4wi.toolkit",
"projectId": "62d86f0068c4fc0001c4d63f",
"appOs": "android"
}
}
},
"where": {
"geofenceName": "Emi home",
"geofenceMetadata": [],
"geofenceId": "968bb2b8184f46af916e27aa619791f2",
"geofenceExtId": "Emilia",
"geofenceJSON": {
"type": "Circle",
"coordinates": [
10.517064,
43.675929
],
"radius": 100
}
},
"when": {
"createdAt": "2022-10-05T07:27:26Z",
"createdAtLocal": "2022-10-05T09:27:26Z",
"timezone": "Europe/Rome"
}
}
]
}
Last updated
Was this helpful?