> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sacul.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# List Objects

> Native S3 listing for the bucket.

Native S3 listing for the bucket. Unlike the search API, this returns raw S3 object data.

## Authentication

Requires an API Key via `Authorization`, `X-API-Key`, or `apiKey` query parameter.

## Query Parameters

<ParamField query="bucketName" type="string" required>
  The name of the bucket to list.
</ParamField>

<ParamField query="prefix" type="string">
  Filter by path prefix (e.g., `uploads/`).
</ParamField>

<ParamField query="maxKeys" type="number" default="1000">
  Max items to return (maximum 1000).
</ParamField>

<ParamField query="continuationToken" type="string">
  For pagination.
</ParamField>

## Example

```bash theme={null}
curl "https://cdn.sacul.cloud/api/list-objects?bucketName=my-bucket&prefix=images/" \
    -H "Authorization: Bearer <your-api-key>"
```