---
title: "List files"
method: GET
path: "/files"
tags: ["files"]
---

# List files

`GET /files`

Returns a paginated list of your uploaded files.

Use cursor-based pagination: pass `last_id` from the response as the `after` parameter to fetch the next page.

## Query parameters

- `pagination` object, required — Cursor-based pagination parameters for OpenAI-compatible endpoints. Used by batch and files APIs following OpenAI's pagination pattern: - `after`: Cursor ID to start after (exclusive) - `limit`: Maximum items to return (default: 20, max: 100)
  - `after` string, nullable — A cursor for use in pagination. `after` is an object ID that defines your place in the list.
  - `limit` integer, nullable — Maximum number of items to return (default: 20, max: 100)
- `order` string
- `purpose` string, nullable
- `search` string, nullable
- `own` boolean
- `member_id` string, uuid, nullable

## Response `200`

List of files. Check `has_more` to determine if additional pages exist.

- FileListResponse — Response for file list
  - `data` FileResponse[], required
    - `bytes` integer, required
    - `context_name` string, nullable — Context name: "Personal" for individual files, or the organization name
    - `context_type` string, nullable — Context type: "personal" or "organization"
    - `created_at` integer, required
    - `created_by_email` string, nullable — Email of the individual who created this file (resolved from api_key attribution)
    - `expires_at` integer, nullable
    - `filename` string, required
    - `id` string, required
    - `object` 'file', required — Object type - always "file"
    - `purpose` 'batch' | 'batch_output' | 'batch_error', required — Purpose for file
    - `source` string, nullable — Source: "sync" if ingested from an external connection, absent for uploaded files
    - `source_name` string, nullable — Name of the source connection (e.g. "prod-s3-inputs")
  - `first_id` string, nullable
  - `has_more` boolean, required
  - `last_id` string, nullable
  - `object` 'list', required — Object type for lists - always "list"

## Other responses

- `500` — An unexpected error occurred. Retry the request or contact support if the issue persists.

---

[API](https://skmtc.dev/doubleword/apis/doubleword-api.md) · [All operations](https://skmtc.dev/doubleword/apis/doubleword-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/doubleword/doubleword-api/revisions/6617202865d8/schema)