---
type: api
title: Get VectorDB projects
description: Fetches a list of VectorDB projects.
url: https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/cloud-serverless/operation/operation-listvectordbprojects
resource: https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/cloud-serverless/operation/operation-listvectordbprojects
products:
  - Elastic Cloud Serverless
---

# Get VectorDB projects

- Server: `https://api.elastic-cloud.com`

## Paths

- `GET` `/api/v1/serverless/projects/vectordb`

- [Api key auth](/elastic/docs-builder/docs/4371/api/doc/cloud-serverless/authentication#apikey)

## Description

Fetches a list of VectorDB projects.

## Query String Parameters

- `traffic_filter` (string)
  Filters the returned list of projects. Only projects associated with the provided traffic_filter will be returned.
- `linked` (string · pattern: ^[a-z0-9]{32}$)
  Contains a project ID. If specified, the result will be filtered to only those origin projects that are linked to the specified project ID in a cross-project search configuration.
- `tags` (ProjectTags)
  If specified, the result will be filtered to only those projects that have the specified tags and corresponding values.

## Responses

#### `200`

The VectorDB project list

`application/json`

- `next_page` (string) — deprecated
  A token to fetch the next page.
- `items` ([] VectorDBProject)
  The actual projects.
  - `id` (string · pattern: ^[a-z0-9]{32}$)
    ID of the project.
  - `name` (string · min: 1 · max: 255)
    Descriptive name for a project.
  - `alias` (string · min: 8 · max: 57 · pattern: ^[a-zA-Z]{1}(?:[a-zA-Z0-9-]*[a-zA-Z0-9]{1})?$)
    A domain label compatible with RFC-1035 standards. Project alias with a unique suffix added by the system to avoid naming conflicts.
  - `region_id` (string)
    Unique human-readable identifier for a region in Elastic Cloud.
  - `metadata` ({} ProjectMetadata)
    Additional details about the project.
    - `created_at` (string)
      Date and time when the project was created.
    - `created_by` (string)
      ID of the user.
    - `organization_id` (string)
      The Organization ID who owns the project.
    - `suspended_at` (string)
      Date and time when the project was suspended.
    - `suspended_reason` (string)
      Reason why the project was suspended.
    - `tags` (ProjectTags)
      Tags associated with a project in the form of key-value pairs. Tags are limited to a minimum of 1 and a maximum of 64 per project. Each tag key must begin with a lowercase letter (a-z), contain only lowercase letters, digits, underscores, and hyphens (a-z0-9_-), and have a maximum length of 32 characters.
    - `system_tags` (ProjectSystemTags)
      System tags associated with a project in the form of key-value pairs. These tags are added by the internal system and are read-only. The keys are prefixed with an underscore to differentiate them from user tags.
  - `cloud_id` (string)
    The cloud ID, an encoded string that provides other Elastic services with the necessary information to connect to this Elasticsearch and Kibana.
  - `traffic_filters` ([] TrafficFilters)
    traffic filters IDs
    - `id` (string)
      traffic filter ID
  - `linked` ({} LinkConfiguration)
    Configuration for projects linked to this project
    - `projects` (map string to LinkedProject)
      Map values ({} LinkedProject)
      - `status` (enum LinkedProjectStatus)
        The state of the linked project.
        Values: `enabled`, `suspended`, `deleted`
      - `type` (enum ProjectType)
        The type of the linked project
        Values: `elasticsearch`, `observability`, `security`, `vectordb`
  - `type` (enum)
    the type of the project
    Values: `vectordb`
  - `endpoints` ({} VectorDBProjectEndpoints)
    The endpoints to access the different apps of the project.
    - `elasticsearch` (string)
      The endpoint to access elasticsearch.
    - `kibana` (string)
      The endpoint to access kibana.
  - `private_endpoints` ({} VectorDBProjectPrivateEndpoints)
    Private endpoints (URLs) for VectorDB projects when PrivateLink is enabled.
    - `elasticsearch` (string)
      The PrivateLink endpoint URL to access elasticsearch.
    - `kibana` (string)
      The PrivateLink endpoint URL to access kibana.
  - `search_lake` ({} VectorDBSearchLake)
    Configuration for entire set of capabilities that make the data searchable in VectorDB.
    - `search_power` (integer · min: 100 · max: 1900 · × 100)
      Controls how fast searches are against your project data. Must be a multiple of 100.
#### `401`

Unauthorized

`application/json`

- `errors` ([] ErrorResponse)
  - `message` (string)
    A human-readable message of the error.
  - `code` (string)
    An identifier for this type of error.
## Code Examples

#### Console

```console
GET /api/v1/serverless/projects/vectordb
```

#### curl

```curl
curl -X GET "https://api.elastic-cloud.com/api/v1/serverless/projects/vectordb"
```