---
title: SFTP File List
slug: sftp-file-list
docTags: 
createdAt: 2022-11-25T15:26:48.000Z
---

Gives you a list of files as a JSON List from a defined SFTP locations.





### API Definition

:::ApiMethodV2
```json
{
  "tab": "examples",
  "url": "https://orca.pathfix.com/functions/web/sftplist",
  "name": "SFTP File List API",
  "method": "POST",
  "request": {
    "pathParameters": [],
    "queryParameters": [],
    "headerParameters": [],
    "bodyDataParameters": [],
    "formDataParameters": []
  },
  "results": {
    "languages": [
      {
        "id": "28UsDqyeH3QRdmtVamSQT",
        "code": "{\n    \"output\": [\n        {\n            \"name\": \"textfile.txt\",\n            \"path\": \"/folder/subfolder/textfile.txt\",\n            \"last_write\": 133101237610000000\n        },\n        {\n            \"name\": \"datafile.dat\",\n            \"path\": \"/folder/subfolder/datafile.dat\",\n            \"last_write\": 133101249210000000\n        }\n    ]\n}",
        "language": "200"
      },
      {
        "id": "yIX64DyIuDPJgBRFSfAWb",
        "code": "{\n    \"message\": \"error\"\n}",
        "language": "404"
      }
    ],
    "selectedLanguageId": "28UsDqyeH3QRdmtVamSQT"
  },
  "examples": {
    "languages": [
      {
        "id": "ENcJz9TStG38F0X-taA4x",
        "code": "{\r\n\t\"input\": {\r\n\t\t\"user_name\": \"username\",\r\n\t\t\"password\": \"password\",\r\n\t\t\"directory_path\": \"ftp://domain.com:22/folder/subfolder\"\r\n\t}\r\n}",
        "language": "json"
      }
    ],
    "selectedLanguageId": "ENcJz9TStG38F0X-taA4x"
  },
  "description": "\nCall the following API:",
  "currentNewParameter": {
    "label": "Body Parameter",
    "value": "bodyDataParameters"
  }
}
```
:::