List files

GET

/files

Get all files for the authenticated user/organization

Returns a paginated list of files with support for pagination, sorting, and search.
For user authentication, returns only the user's files within their active organization.
For organization authentication, returns all organization files.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.perfectworks.io/api/v0/files'

Response Example

200 - Example 1

{
    "success": true,
    "message": "Items retrieved successfully",
    "data": [
        {
            "id": "1",
            "name": "Item 1"
        },
        {
            "id": "2",
            "name": "Item 2"
        }
    ],
    "pagination": {
        "page": 1,
        "limit": 10,
        "total": 25,
        "pages": 3,
        "hasNext": true,
        "hasPrev": false
    }
}

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Responses

🟢200OK

application/json

Files retrieved successfully

Body

🟠401Unauthorized

🔴500Server Error

Modified at 2025-08-22 18:48:44

Create file record

Get file by ID