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 for an organziation id

get

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

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

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

statusstringOptional

OK

generatedstringOptional

date time of response

countnumberOptional

default

Error

application/json

get

/v1/organizations/{cid}/events

HTTPcURLJavaScriptPython

GET /v1/organizations/{cid}/events HTTP/1.1
Host: explore.cloud4wi.com/
Authorization: Bearer YOUR_SECRET_TOKEN
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 of a specific Contact

get

List all events, including WiFi Connections, Visits and applicaiton events of a given Contact Id Role: Organization Manager Scope: organization_read, events_read

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

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

statusstringOptional

OK

generatedstringOptional

date time of response

countnumberOptional

default

Error

application/json

get

/v1/organizations/{cid}/customers/{id}/events

HTTPcURLJavaScriptPython

GET /v1/organizations/{cid}/customers/{id}/events HTTP/1.1
Host: explore.cloud4wi.com/
Authorization: Bearer YOUR_SECRET_TOKEN
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"
      }
    }
  ]
}