---
title: "List Vector Databases"
method: GET
path: "/v1/vector_databases/list"
tags: ["vector_databases"]
---

# List Vector Databases

`GET /v1/vector_databases/list`

## Query parameters

- `page` integer
- `size` integer
- `sort_column` string, nullable
- `sort_desc` boolean, nullable

## Response `200`

Successful Response

- VectorDatabasePage
  - `items` PineconeVectorDatabase[], required
    - `id` string, uuid, required
    - `user_id` string, uuid, required
    - `type` 'vector_database_pinecone', required
    - `index` string, required
    - `api_key` string, required
    - `api_environment` string, required
  - `page` integer, required
  - `size` integer, required
  - `has_more` boolean, required
  - `total` integer, required
  - `total_is_estimated` boolean, required

## Other responses

- `422` — Validation Error

## Changes

- **2024-08-14** `63991d99e2e1` — 5 info
  - `query` request parameter `sort_column` list-of-types was widened by adding types `null`
  - `query` request parameter `sort_desc` list-of-types was widened by adding types `null`
  - for the `query` request parameter `sort_column`, the type/format was generalized from `string`/`` to ``/``
  - for the `query` request parameter `sort_desc`, the type/format was generalized from `boolean`/`` to ``/``
  - …1 more
- **2024-04-19** `55ae0e0bb01f` — 2 info
  - added the required property `total` to the response with the `200` status
  - added the required property `total_is_estimated` to the response with the `200` status
- **2024-03-18** `8b2983fa7531` — 5 info
  - added the new optional `query` request parameter `page`
  - added the new optional `query` request parameter `size`
  - added the new optional `query` request parameter `sort_column`
  - added the new optional `query` request parameter `sort_desc`
  - …1 more
- **2024-03-18** `500a519452b0` — 2 warning, 1 info
  - deleted the `query` request parameter `page`
  - deleted the `query` request parameter `size`
  - removed the non-success response with the status `422`
- **2023-08-26** `bcabbf21f339` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/vocodedev/apis/vocode-hosted-api/changes/v1/vector_databases/list/get.md)

---

[API](https://skmtc.dev/vocodedev/apis/vocode-hosted-api.md) · [All operations](https://skmtc.dev/vocodedev/apis/vocode-hosted-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vocodedev/vocode-hosted-api/revisions/ffca17c004e2/schema)