Sign in
Files

List Files

Returns the files with the given IDs, newest first — fetch a batch in one request instead of retrieving each file individually. Only files you created are returned; IDs that do not exist, or that another credential created, are omitted. A request for up to 100 IDs answers in a single page by default; a larger batch pages at up to 100 files per response — follow page_info with the same file_ids to walk the rest.

get/files

Query parameters

file_idsstring[] required

The files to return, each prefixed file_. Repeat the parameter to pass several, up to 250 per request. Batches of up to 100 answer in one page by default; larger batches page at up to 100 per response.

[
  "file_xxxxxxxxxxxxx"
]
order'created_at'

The field to sort by.

direction'asc' | 'desc'

The sort direction.

firstinteger

The number of files to return.

afterstring

A cursor; returns files after this position.

lastinteger

The number of files to return from the end of the range.

beforestring

A cursor; returns files before this position.

Response

files listed

Example response

{
  "data": [
    {
      "content_type": "application/pdf",
      "created_at": "2026-01-01T12:00:00.000Z",
      "filename": "evidence.pdf",
      "id": "file_xxxxxxxxxxxxxx",
      "multipart_chunk_size": 5242880,
      "multipart_upload_id": "upload-id",
      "multipart_upload_urls": [
        {
          "part_number": 1,
          "url": "https://whop-assets-example.s3.amazonaws.com/uploads/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/application.pdf"
        }
      ],
      "object": "file",
      "size": 9670,
      "upload_headers": {},
      "upload_status": "pending",
      "upload_url": "https://whop-assets-example.s3.amazonaws.com/uploads/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/application.pdf",
      "url": "https://whop-assets-example.s3.amazonaws.com/uploads/audio/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "visibility": "private"
    }
  ],
  "page_info": {
    "end_cursor": "WyJjdXJzb3IiLDFd",
    "has_previous_page": true,
    "start_cursor": "WyJjdXJzb3IiLDFd"
  }
}

Changes