---
title: "List Objects Endpoint"
method: GET
path: "/files/{bucket}/{prefix}"
tags: ["files"]
---

# List Objects Endpoint

`GET /files/{bucket}/{prefix}`

## Path parameters

- `bucket` string, required
- `prefix` string, required

## Query parameters

- `include_version` boolean
- `recursive` boolean
- `start_after` string, nullable

## Response `200`

Successful Response

- ListObjectsResponse
  - `objects` ObjectMetadata[]
    - `bucket_name` string, required
    - `object_name` string, required
    - `last_modified` string, date-time, nullable
    - `is_latest` boolean, nullable
    - `etag` string, nullable
    - `size` integer, nullable
    - `content_type` string, nullable
    - `version_id` string, nullable
    - `version_tag` string, nullable
    - `metadata` object, nullable

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `422` — Unprocessable Content
- `500` — Internal Server Error

---

[API](https://skmtc.net/hf/apis/extralit-v1.md) · [All operations](https://skmtc.net/hf/apis/extralit-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hf/extralit-v1/versions/e9da3a893a88/schema)