---
title: "List Blobs"
method: GET
path: "/v1/blobs"
tags: ["blobs"]
---

# List Blobs

`GET /v1/blobs`

## Request

- Base URL: `https://api.lithtrix.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.lithtrix.ai/v1/blobs`
- Auth: none declared

List stored blobs for the authenticated agent (metadata only, paginated).

## Query parameters

- `page` integer
- `per_page` integer

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- BlobListResponse: Paginated list of blobs for the authenticated agent.
  - `status` 'success'
  - `blobs` BlobListItem[], required
    - `blob_id` string, required
    - `size_bytes` integer, required
    - `content_type` string, required
    - `filename` string, nullable
    - `sha256` string, required
    - `created_at` string, required
  - `total` integer, required
  - `page` integer, required
  - `per_page` integer, required

## Other responses

- `422`: Validation Error

---

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