---
title: "List a drop's files"
method: GET
path: "/drops/{slug}/contents"
---

# List a drop's files

`GET /drops/{slug}/contents`

## Request

- Base URL: `https://ship.page`
- URL: `https://ship.page/drops/{slug}/contents`
- Auth: HTTP bearer

Every file the drop serves, sorted by path, with its size and MIME type. Also works for expired and taken-down drops, for whatever is still stored.

## Response `200`

Files.

- object
  - `files` DropContentFile[], required
    - `path` string, required
    - `bytes` integer, required
    - `mime` string, required
  - `bytes` integer, required: Total size of the files.

## Other responses

- `401`: Missing or invalid credential.
- `404`: Not found (also returned for resources owned by someone else).
- `503`: Required backend unavailable. Password creation and rotation fail closed when billing cannot be verified; retry later.

## Changes

- **2026-10-20** `99aad34506e8`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ship/apis/ship-page/changes/drops/:slug/contents/get.md)

---

[API](https://skmtc.dev/ship/apis/ship-page.md) · [All operations](https://skmtc.dev/ship/apis/ship-page/llms.txt) · [OpenAPI document](https://skmtc.dev/ship/apis/ship-page/revisions/99aad34506e8?raw)