List files for a hosting account

List files and directories within a specific folder on your hosting account. This is useful for managing your website files, for example, within the `public_html` directory.

Web Hosting Services Hosting Accounts

Context

Where to get IDs / values

Path Parameters

accountId integer · min: 1 required Example: 20000

Unique account identifier

Query Parameters

dir string required · Example: public_html

Headers

Accept Example
Content-Type Example

Responses

200
data object required
data.accountId string required · Example: 20000
data.count integer · Example: 23
data.cpanelUsername string required · Example: xkqjm
data.dir string required · Example: example.com
data.files object | array required
data.files.data string · nullable required · Example: null

Nullable: may be null when not applicable.

data.files.errors array<string> required · Example: ["The directory /home/vdcoe/example.com does not exist."]
data.files.messages string · nullable required · Example: null

Nullable: may be null when not applicable.

data.files.metadata object required
data.files.status integer required · Example: 0
data.files.warnings string · nullable required · Example: null

Nullable: may be null when not applicable.

data.success boolean required · Example: true

True for successful responses.

requestId string required · Example: 2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba

Unique request identifier (UUID).

success boolean required · Example: true

True for successful responses.

timestamp string required · Example: 2026-02-10T00:00:00.000Z

ISO 8601 timestamp (UTC).

400
code string required · Example: BAD_REQUEST

Machine-readable error code.

error string required · Example: Bad Request

HTTP status title (e.g. 'Bad Request').

message string required · Example: Invalid dir parameter

Human-readable message.

requestId string required · Example: 2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba

Unique request identifier (UUID).

timestamp string required · Example: 2026-02-10T00:00:00.000Z

ISO 8601 timestamp (UTC).

500
code string required · Example: INTERNAL_ERROR

Machine-readable error code.

error string required · Example: Internal Server Error

HTTP status title (e.g. 'Bad Request').

message string required · Example: An unexpected error occurred

Human-readable message.

requestId string required · Example: 2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba

Unique request identifier (UUID).

timestamp string required · Example: 2026-02-10T00:00:00.000Z

ISO 8601 timestamp (UTC).

GET https://cloud.hostup.se/api/hosting/{accountId}/files
For AI assistants
cURL 
curl -X GET "https://cloud.hostup.se/api/hosting/20000/files?dir=public_html" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"
Response 
"{\"success\":true,\"timestamp\":\"2026-02-10T00:00:00.000Z\",\"requestId\":\"98e87359-b3f5-47f8-87df-29441a2bd552\",\"data\":{\"success\":true,\"accountId\":\"1436\",\"cpanelUsername\":\"aibo\",\"dir\":\"public_html\",\"files\":[{\"file\":\"1apa1\",\"humansize\":\"24 byte\",\"mimename\":\"httpd-unix-directory\",\"size\":\"24\",\"uid\":1442,\"exists\":1,\"fullpath\":\"/home/aibo/public_html/1apa1\",\"gid\":1446,\"write\":1,\"path\":\"/home/aibo/public_html\",\"rawmimetype\":\"httpd/unix-directory\",\"type\":\"dir\",\"rawmimename\":\"httpd-unix-directory\",\"nicemode\":..."