Skip to main content
GET
/
storage
/
provisioning
/
v3
/
storages
/
sftp
List SFTP storages
curl --request GET \
  --url https://api.gcore.com/storage/provisioning/v3/storages/sftp \
  --header 'Authorization: <api-key>'
{
  "count": 1,
  "results": [
    {
      "address": "mia.origin.gcdn.co",
      "created_at": "2025-08-05 09:17:02.095832+00:00",
      "credentials": {
        "sftp_password": "Xy9$mN2p!qR8",
        "ssh_keys": [
          {
            "created_at": "2025-08-05 09:15:00+00:00",
            "id": 123,
            "name": "my-production-key",
            "public_key": "ssh-rsa AAAAB3NzaC1yc2EAAA... user@example.com"
          }
        ]
      },
      "id": 1,
      "location_name": "mia",
      "name": "my-sftp-storage",
      "provisioning_status": "ok",
      "custom_config_file": false,
      "disable_http": false,
      "expires": "2 years 6 months",
      "server_alias": "my-storage.example.com"
    }
  ]
}

Authorizations

Authorization
string
header
required

API key for authentication. Make sure to include the word apikey, followed by a single space and then your token. Example: apikey 1234$abcdef

Query Parameters

id
string

Filter by storage ID

name
string

Filter by storage name

location_name
string

Filter by storage location/region

offset
integer<uint64>

Number of records to skip

Required range: x >= 0
limit
integer<uint64>
default:10

Max number of records in response

Required range: 1 <= x <= 1000
order_by
string

Field and direction to sort by (format: field.asc or field.desc)

status
enum<string>

Filter by storage status

Available options:
active,
suspended,
deleted,
pending
show_deleted
boolean

Include deleted storages

Response

SFTPStorageListEndpointResV3

SFTPStorageListEndpointResV3 response for listing SFTP storages V3

count
integer<int64>
required

Total number of SFTP storages matching the filter

Example:

1

results
object[]
required

The list of SFTP storages