---
title: "List vector stores (OpenAI-compatible)."
method: GET
path: "/v1/vector_stores"
tags: ["VectorIO"]
---

# List vector stores (OpenAI-compatible).

`GET /v1/vector_stores`

List vector stores (OpenAI-compatible).

## Query parameters

- `limit` integer, nullable — Maximum number of vector stores to return.
- `order` string, nullable — Sort order by created_at: asc or desc.
- `after` string, nullable — Pagination cursor (after).
- `before` string, nullable — Pagination cursor (before).

## Response `200`

A list of vector stores.

- VectorStoreListResponse — Response from listing vector stores.
  - `object` 'list'
  - `data` VectorStoreObject[], required
    - `id` string, required
    - `object` 'vector_store'
    - `created_at` integer, required
    - `name` string
    - `usage_bytes` integer
    - `file_counts` VectorStoreFileCounts, required — File processing status counts for a vector store.
      - `completed` integer, required
      - `cancelled` integer, required
      - `failed` integer, required
      - `in_progress` integer, required
      - `total` integer, required
    - `status` 'expired' | 'in_progress' | 'completed', required
    - `expires_after` VectorStoreExpirationAfter — Expiration policy for a vector store.
      - `anchor` 'last_active_at', required — Anchor timestamp after which the expiration policy applies.
      - `days` integer, required — The number of days after the anchor time that the vector store will expire.
    - `expires_at` integer, nullable
    - `last_active_at` integer, nullable
    - `metadata` object, nullable
  - `first_id` string, required
  - `last_id` string, required
  - `has_more` boolean, required

## Other responses

- `400` — The request was invalid or malformed
- `429` — The client has sent too many requests in a given amount of time
- `500` — The server encountered an unexpected error
- `default` — An error occurred

---

[API](https://skmtc.net/ogx-ai/apis/ogx-specification-stable-experimental-apis.md) · [All operations](https://skmtc.net/ogx-ai/apis/ogx-specification-stable-experimental-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ogx-ai/ogx-specification-stable-experimental-apis/versions/f3f783962256/schema)