---
title: "Returns a list of vector stores."
method: GET
path: "/vector_stores"
tags: ["Vector Stores"]
---

# Returns a list of vector stores.

`GET /vector_stores`

## Query parameters

- `limit` integer
- `order` 'asc' | 'desc'
- `after` string
- `before` string

## Response `200`

OK

- ListVectorStoresResponse
  - `object` string, required
  - `data` VectorStoreObject[], required
    - `id` string, required — The identifier, which can be referenced in API endpoints.
    - `object` 'vector_store', required — The object type, which is always `vector_store`.
    - `created_at` integer, required — The Unix timestamp (in seconds) for when the vector store was created.
    - `name` string, required — The name of the vector store.
    - `usage_bytes` integer, required — The total number of bytes used by the files in the vector store.
    - `file_counts` object, required
      - `in_progress` integer, required — The number of files that are currently being processed.
      - `completed` integer, required — The number of files that have been successfully processed.
      - `failed` integer, required — The number of files that have failed to process.
      - `cancelled` integer, required — The number of files that were cancelled.
      - `total` integer, required — The total number of files.
    - `status` 'expired' | 'in_progress' | 'completed', required — The status of the vector store, which can be either `expired`, `in_progress`, or `completed`. A status of `completed` indicates that the vector store is ready for use.
    - `expires_after` VectorStoreExpirationAfter — The expiration policy for a vector store.
      - `anchor` 'last_active_at', required — Anchor timestamp after which the expiration policy applies. Supported anchors: `last_active_at`.
      - `days` integer, required — The number of days after the anchor time that the vector store will expire.
    - `expires_at` integer, nullable — The Unix timestamp (in seconds) for when the vector store will expire.
    - `last_active_at` integer, nullable, required — The Unix timestamp (in seconds) for when the vector store was last active.
    - `metadata` object, nullable, required — Set of 16 key-value pairs that can be attached to an object. This can be useful for storing additional information about the object in a structured format. Keys can be a maximum of 64 characters long and values can be a maximum of 512 characters long.
  - `first_id` string, required
  - `last_id` string, required
  - `has_more` boolean, required

---

[API](https://skmtc.net/omnistack-sh/apis/openai-api.md) · [All operations](https://skmtc.net/omnistack-sh/apis/openai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/omnistack-sh/openai-api/versions/a127ad1d97cb/schema)