---
title: "List the files on a collection, newest first"
method: GET
path: "/api_partner/collections/{collection_slug}/files"
tags: ["Collections"]
---

# List the files on a collection, newest first

`GET /api_partner/collections/{collection_slug}/files`

## Request

- Base URL: `https://api.scite.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.scite.ai/api_partner/collections/{collection_slug}/files`
- Auth: HTTP bearer

Files are team-internal: the user named by `email` must be a member of the Collection
(owner, shared on it, or in an organization it is shared with). A Collection being
public does not make its files readable.

## Path parameters

- `collection_slug` string, required

## Query parameters

- `email` string, email, required
- `limit` integer
- `offset` integer
- `text_search` string, nullable: Filter to files whose name contains this text.

## Headers

- `authorization` string: Set to `Bearer <token>` to pass token for authorization.

## Response `200`

Successful Response

- CollectionFilesListRS
  - `results` CollectionFileSchema[], required
    - `id` integer, required
    - `dashboardId` integer, required
    - `targetType` 'COLLECTION'
    - `filename` string, required
    - `contentType` string, required
    - `byteSize` integer, required
    - `createdByEmail` string, nullable
    - `createdByName` string, nullable
    - `createdAt` string, date-time, required
    - `lastUpdated` string, date-time, required
    - `suspended` boolean
  - `total` integer, required
  - `limits` CollectionFileLimits, required: The caps, sent with every list so the client does not hold its own copy. The values live in Python config, so a browser-side constant would be a second source that drifts.
    - `maxFileBytes` integer, required
    - `maxCollectionBytes` integer, required
    - `maxCollectionFiles` integer, required
    - `usedBytes` integer, required
    - `usedFiles` integer, required
    - `previewableContentTypes` string[], required
    - `previewMaxBytes` integer, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-01** `97e32261f535`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/scite/apis/scite-api/changes/api_partner/collections/:collection_slug/files/get.md)

---

[API](https://skmtc.dev/scite/apis/scite-api.md) - [All operations](https://skmtc.dev/scite/apis/scite-api/llms.txt) - [OpenAPI document](https://skmtc.dev/scite/apis/scite-api/revisions/d34bcc742a26?raw)