---
title: "List SFTP Action Logs"
method: GET
path: "/sftp_action_logs"
tags: ["sftp_action_logs", "SFTP Action Logs"]
---

# List SFTP Action Logs

`GET /sftp_action_logs`

List SFTP Action Logs

## Query parameters

- `cursor` string
- `per_page` integer

## Response `200`

A list of SftpActionLogs objects.

- SftpActionLogEntity[]
  - `timestamp` string, date-time — Start Time of Action. Deprecrated: Use created_at.
  - `remote_ip` string — IP Address of SFTP Client
  - `server_ip` string — IP Address of SFTP Server
  - `username` string — Username
  - `ssh_client_identification` string — Name of the SFTP Client provided at initial connection
  - `session_uuid` string — Unique ID of the Session
  - `seq_id` integer — SFTP Sequence ID
  - `auth_method` string — Authentication Method
  - `auth_ciphers` string — Authentication Ciphers
  - `action_type` string — Action Type
  - `path` string — Path as sent by the Client (may not match Files.com path due to user root folders for SFTP).
  - `true_path` string — Path on Files.com
  - `name` string — Name of File
  - `sftp_response_code` string — SFTP Response Code Returned to the Client.
  - `sftp_response_message` string — SFTP Response Message Returned to the Client.
  - `md5` string — MD5 Hash of the file. Not always available.
  - `size` integer — Size of File That was Uploaded or Downloaded.
  - `data_length` integer — Data Length in Bytes. Present for actions that transfer data.
  - `bytes_transferred` integer — The number of bytes transferred for uploads and downloads.
  - `entries_returned` integer — Number of entries returned when listing files and folders
  - `success` boolean — Whether SFTP Action was successful.
  - `status` 'SUCCESS' | 'FAILURE' | 'PARTIAL_TRANSFER' — SFTP Action status.
  - `duration_ms` integer — Duration (in milliseconds)
  - `created_at` string, date-time — Start Time of Action

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `405` — Method Not Allowed
- `409` — Conflict
- `412` — Precondition Failed
- `422` — Unprocessable Entity
- `423` — Locked
- `429` — Too Many Requests

---

[API](https://skmtc.net/files/apis/files-com-api.md) · [All operations](https://skmtc.net/files/apis/files-com-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/files/files-com-api/revisions/c6d6f57e6da8/schema)