curl -X GET "https://your-zipline.com/api/user/files?page=1&perpage=15" \
-H "Authorization: YOUR_TOKEN"
GET /api/user/files
Retrieve a paginated list of files with support for filtering, sorting, and searching.
Query Parameters
Page number for pagination (1-indexed)
Filter files by type
dashboard - Only media files (image, video, audio, text)none - No filter appliedall - All files including favorites
Filter to show only favorited files
Field to sort files by
id - File IDcreatedAt - Creation dateupdatedAt - Last update datedeletesAt - Scheduled deletion datename - File nameoriginalName - Original file namesize - File sizetype - MIME typeviews - View countfavorite - Favorite status
Sort order
asc - Ascendingdesc - Descending
Field to search in
name - File name on serveroriginalName - Original uploaded file nametype - MIME typetags - Tag IDs (comma-separated)id - File ID
Search query string. When searching by tags, use comma-separated tag IDs
Filter files by a specific user ID (requires permission)
Filter files by folder ID
Response
Array of file objects
Original name of the uploaded file
Number of times the file has been viewed
Maximum allowed views before deletion
Whether the file is marked as favorite
Whether the file is password-protected
ID of the folder containing this file
ISO 8601 timestamp of file creation
ISO 8601 timestamp of last update
ISO 8601 timestamp of scheduled deletion
Full URL to access the file
Thumbnail information if availablePath to the thumbnail file
Total number of files matching the query (only present without search)
Total number of pages (only present without search)
Search metadata (only present when searching)The field that was searched
The search query (array when searching tags)
Example Response
{
"page": [
{
"id": "clxyz123",
"name": "abc123.png",
"originalName": "screenshot.png",
"size": 152400,
"type": "image/png",
"views": 42,
"maxViews": null,
"favorite": false,
"password": false,
"folderId": null,
"createdAt": "2024-01-15T10:30:00.000Z",
"updatedAt": "2024-01-15T10:30:00.000Z",
"deletesAt": null,
"url": "https://your-zipline.com/u/abc123.png",
"thumbnail": {
"path": "/thumbnails/abc123.jpg"
},
"tags": [
{
"id": "tag1",
"name": "screenshots",
"color": "#3b82f6",
"createdAt": "2024-01-10T08:00:00.000Z",
"updatedAt": "2024-01-10T08:00:00.000Z"
}
]
}
],
"total": 150,
"pages": 10
}
Search Example Response
{
"page": [
{
"id": "clxyz123",
"name": "screenshot-2024.png",
"originalName": "screenshot.png",
"size": 152400,
"type": "image/png",
"views": 42,
"maxViews": null,
"favorite": false,
"password": false,
"folderId": null,
"createdAt": "2024-01-15T10:30:00.000Z",
"updatedAt": "2024-01-15T10:30:00.000Z",
"deletesAt": null,
"url": "https://your-zipline.com/u/screenshot-2024.png",
"thumbnail": null,
"tags": []
}
],
"search": {
"field": "originalName",
"query": "screenshot"
}
}