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

Number of results to return from the start of the range.

afterstring

Return results after this cursor. Use page_info.end_cursor from the previous response to fetch the next page.

lastinteger

Number of results to return from the end of the range.

beforestring

Return results before this cursor. Use page_info.start_cursor from the previous response to fetch the previous page.

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": {
    "has_previous_page": true,
    "start_cursor": "WyJjdXJzb3IiLDFd"
  }
}

Changes

Changed in 2 of the 74 revisions of this API.21

  • ff3a765735632See the full diff
    • ●

      for the query request parameter first, the max was set to 100.00

      request-parameter-max-set

    • ●

      for the query request parameter last, the max was set to 100.00

      request-parameter-max-set

  • 621705ee8f4a1See the full diff
    • ○

      endpoint added

      endpoint-added

    This revision also has 6 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Of the 74 revisions, 1 has no diff computed.