Get activity logs

v1.0.0

Returns the detailed activity logs for your account. Optional query paramaters will filter the returned results based on a number of options including usernames, activity types, or date ranges.

NOTE: Total Results will always return as 0 to avoid quering data you're not using and stay as performant as possible.

Operation Types Session activity is logged with an operation type that is different from what is visible through the . Consult the table below to compare the two:

File Manager Value	API Value	Notes
Connect	PASS
Disconnect	EXIT
Upload	STOR
Download	RETR
Delete	DELE
Create Folder	MKD
Rename	RNTO
Move	MOVE
Copy	COPY
Compress	COMPR
Extract	EXTRACT
Shared Folders	SHARE
Send Files	SEND
Receive Files	RECV
N/A	EDIT_SEND	Update send. Not shown in file manager
Update Share	EDIT_SHARE
Update Receive	EDIT_RECV
Delete Send	DELE_SEND
Delete Receive	DELE_RECV
Delete Share	DELE_SHARE
Create Notification	NOTIFY
Update Notification	EDIT_NTFY
Delete Notification	DELE_NTFY
Create User	USER
Update User	EDIT_USER
Delete User	DELE_USER
N/A	DFA	Create direct link. Not shown in file manager
N/A	EDIT_DFA	Update direct link options. Not shown in file manager
N/A	DELE_DFA	Deactivate direct link. Not shown in file manager

Input

{
  "type": "object",
  "properties": {
    "endDate": {
      "type": "string",
      "format": "date-time"
    },
    "ev-access-token": {
      "type": "string"
    },
    "ev-api-key": {
      "type": "string"
    },
    "ipAddress": {
      "type": "string"
    },
    "limit": {
      "type": "integer"
    },
    "offset": {
      "type": "integer"
    },
    "path": {
      "type": "string"
    },
    "sort": {
      "type": "string"
    },
    "startDate": {
      "type": "string",
      "format": "date-time"
    },
    "type": {
      "type": "string"
    },
    "username": {
      "type": "string"
    }
  },
  "required": [
    "ev-access-token",
    "ev-api-key"
  ],
  "additionalProperties": false
}

Output

{
  "type": "object",
  "description": "Session activity list response",
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "description": "Single entry of session activity",
        "properties": {
          "attributes": {
            "type": "object",
            "properties": {
              "bytesTransferred": {
                "type": "integer",
                "format": "int64"
              },
              "created": {
                "type": "string"
              },
              "duration": {
                "type": "integer"
              },
              "fileName": {
                "type": "string"
              },
              "fileSource": {
                "type": "string"
              },
              "ipAddress": {
                "type": "string"
              },
              "operation": {
                "type": "string"
              },
              "protocol": {
                "type": "string"
              },
              "sessionId": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "username": {
                "type": "string"
              }
            }
          },
          "id": {
            "type": "integer",
            "format": "int64"
          },
          "type": {
            "type": "string",
            "enum": [
              "sessionActivity"
            ]
          }
        }
      }
    },
    "responseStatus": {
      "type": "integer"
    },
    "returnedResults": {
      "type": "integer"
    },
    "totalResults": {
      "type": "integer"
    }
  }
}