Skip to main content
GET
/
files
List files
curl --request GET \
  --url https://api.soket.ai/transcribe/files \
  --header 'Authorization: Bearer <token>'
{
  "page": 123,
  "limit": 123,
  "total_pages": 123,
  "total_files": 123,
  "count": 123,
  "files": [
    {}
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.tensorstudio.ai/llms.txt

Use this file to discover all available pages before exploring further.

List all files uploaded by the authenticated user, flattened across upload batches. Returns newest files first.

​
Query params

  • page (default: 1)
  • limit (default: 50, max: 200)
  • upload_status (optional): pending, uploading, completed, failed

​
Example

curl -X GET "https://api.soket.ai/transcribe/files?page=1&limit=50&upload_status=completed" \
  -H "Authorization: Bearer $JWT_TOKEN"

​
Typical response

{
  "page": 1,
  "limit": 50,
  "total_pages": 1,
  "total_files": 2,
  "count": 2,
  "files": [
    {
      "batch_upload_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "file_id": "1374132b-b5db-4ec3-9cf1-f61f982e89b0",
      "filename": "audio1.wav",
      "content_type": "audio/wav",
      "size_bytes": 1048576,
      "estimated_duration_seconds": 65.5,
      "upload_status": "completed",
      "gcs_key": "uploads/2026/06/03/1374132b-b5db-4ec3-9cf1-f61f982e89b0.wav"
    }
  ]
}
gcs_key is only included when upload_status is completed.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
page
integer
default:1
Required range: x >= 1
​
limit
integer
default:50
Required range: 1 <= x <= 200
​
upload_status
enum<string>
Available options:
pending,
uploading,
completed,
failed

Response

Paginated file list

​
page
integer
​
limit
integer
​
total_pages
integer
​
total_files
integer
​
count
integer
​
files
object[]