Get user events

This method allows you to get events that the user has performed in chronological order (from the newest to the oldest).

URL

GET https://api.dashly.app/v1/users/{id}/events

For {id} you can use:

  • Dashly ID
  • Your User ID (in case user with such ID does not exist, new user with such ID is created) (send with by_user_id=true)

Arguments

This method follows the general rules. Arguments are transmitted as GET or POST parameters.

Argument Description
auth_token Required. Authorization token (requires scope: user-read)
filter_name Use to get events with specific name.
after Pagination. The cursor to start with.
count Pagination. The maximum number of messages to be returned (from 1 to 50). Default: 20

More on pagination.

Answer

{
  "meta": {
    "next_after": 335695472,
    "status": 200
  },
  "data": [
    {
      "id": 335704586,
      "created": 1467192929,
      "type": {
        "id": 5857,
        "name": "MyEvent",
        "score": 0,
        "visible": true
      },
      "user": 22735768,
      "props": {
        "App": "Eva99"
      }
    },
    ...
  ]
}

Answer contains Event object.

Example

Get all events of a user:

curl -X GET https://api.dashly.app/v1/users/8173131/events?auth_token=XXX

Get events with name MyEventOne:

curl -X GET https://api.dashly.app/v1/users/8173131/events?auth_token=XXX&filter_name=MyEventOne