---
title: "[DEPRECATED] List vector stores"
method: GET
path: "/v1/vector_stores"
tags: ["deprecated_vector_stores"]
deprecated: true
---

# [DEPRECATED] List vector stores

`GET /v1/vector_stores`

> **Deprecated.**

DEPRECATED: Use GET /stores instead

## Query parameters

- `limit` integer — Maximum number of items to return per page (1-100)
- `after` string, nullable — Cursor for forward pagination - get items after this position. Use last_cursor from previous response.
- `before` string, nullable — Cursor for backward pagination - get items before this position. Use first_cursor from previous response.
- `include_total` boolean — Whether to include total count in response (expensive operation)
- `q` string, nullable — Search query for fuzzy matching over name and description fields

## Response `200`

The list of vector stores

- VectorStoreListResponse
  - `pagination` CursorPaginationResponse, required — Response model for cursor-based pagination.
    - `has_more` boolean, required — Contextual direction-aware flag: True if more items exist in the requested pagination direction. For 'after': more items after this page. For 'before': more items before this page.
    - `first_cursor` string, nullable, required — Cursor of the first item in this page. Use for backward pagination. None if page is empty.
    - `last_cursor` string, nullable, required — Cursor of the last item in this page. Use for forward pagination. None if page is empty.
    - `total` integer, nullable — Total number of items available across all pages. Only included when include_total=true was requested. Expensive operation - use sparingly.
  - `object` 'list' — The object type of the response
  - `data` VectorStore[], required — The list of vector stores
    - `id` string, required — Unique identifier for the vector store
    - `name` string, required — Name of the vector store
    - `description` string, nullable — Detailed description of the vector store's purpose and contents
    - `is_public` boolean — Whether the vector store can be accessed by anyone with valid login credentials
    - `metadata` unknown
    - `file_counts` FileCounts — Tracks counts of files in different states within a store.
      - `pending` integer — Number of files waiting to be processed
      - `in_progress` integer — Number of files currently being processed
      - `cancelled` integer — Number of files whose processing was cancelled
      - `completed` integer — Number of successfully processed files
      - `failed` integer — Number of files that failed processing
      - `total` integer — Total number of files
    - `expires_after` ExpiresAfter — Represents an expiration policy for a store.
      - `anchor` 'last_active_at' — Anchor date for the expiration policy
      - `days` integer — Number of days after which the store expires
    - `status` 'expired' | 'in_progress' | 'completed' — Status of a store.
    - `created_at` string, date-time, required — Timestamp when the vector store was created
    - `updated_at` string, date-time, required — Timestamp when the vector store was last updated
    - `last_active_at` string, date-time, nullable — Timestamp when the vector store was last used
    - `usage_bytes` integer — Total storage usage in bytes
    - `expires_at` string, date-time, nullable — Optional expiration timestamp for the vector store
    - `object` 'vector_store' — Type of the object

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/mixedbread/apis/mxbai-omni.md) · [All operations](https://skmtc.net/mixedbread/apis/mxbai-omni/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mixedbread/mxbai-omni/versions/2eece97b5ae5/schema)