Yandex Cloud
Search
Contact UsTry it for free
  • Customer Stories
  • Documentation
  • Blog
  • All Services
  • System Status
  • Marketplace
    • Featured
    • Infrastructure & Network
    • Data Platform
    • AI for business
    • Security
    • DevOps tools
    • Serverless
    • Monitoring & Resources
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Start testing with double trial credits
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Center for Technologies and Society
    • Yandex Cloud Partner program
    • Price calculator
    • Pricing plans
  • Customer Stories
  • Documentation
  • Blog
© 2026 Direct Cursus Technology L.L.C.
Yandex AI Studio
  • About Yandex AI Studio
  • Getting started with Model Gallery
  • Yandex Workflows
  • Switching from the AI Assistant API to Responses API
  • Compatibility with OpenAI
    • Overview
    • API authentication
        • Overview
        • listVectorStores
        • createVectorStore
        • getVectorStore
        • modifyVectorStore
        • deleteVectorStore
        • createVectorStoreFileBatch
        • getVectorStoreFileBatch
        • listFilesInVectorStoreBatch
        • listVectorStoreFiles
        • createVectorStoreFile
        • getVectorStoreFile
        • deleteVectorStoreFile
        • updateVectorStoreFileAttributes
        • retrieveVectorStoreFileContent
        • searchVectorStore
  • Quotas and limits
  • Pricing policy
  • Access management
  • Audit Trails events
  • Public materials
  • Release notes
  • Terms and definitions

In this article:

  • HTTP request
  • Path parameters
  • Response
  • FileCounts
  • VectorStoreExpirationAfter
  1. API references
  2. OpenAI-compatible APIs
  3. Vector stores
  4. getVectorStore

REST: Retrieve vector store

Written by
Yandex Cloud
Updated at December 30, 2025
  • HTTP request
  • Path parameters
  • Response
  • FileCounts
  • VectorStoreExpirationAfter

Retrieves a vector store.

HTTP requestHTTP request

GET https://ai.api.cloud.yandex.net/v1/vector_stores/{vector_store_id}

Path parametersPath parameters

Field

Description

vector_store_id

string

Required field. The ID of the vector store to retrieve.

ResponseResponse

HTTP Code: 200

OK

Response schema: application/json

{
  "id": "string",
  "object": "string",
  "created_at": "integer",
  "name": "string",
  "usage_bytes": "integer",
  "file_counts": {
    "in_progress": "integer",
    "completed": "integer",
    "failed": "integer",
    "cancelled": "integer",
    "total": "integer"
  },
  "status": "string",
  "expires_after": {
    "anchor": "string",
    "days": "integer"
  },
  "expires_at": "unknown",
  "last_active_at": "unknown",
  "metadata": "unknown"
}

A vector store is a collection of processed files can be used by the file_search tool.

Field

Description

id

string

Required field. The identifier, which can be referenced in API endpoints.

object

enum

Required field. The object type, which is always vector_store.

  • vector_store

created_at

integer

Required field. The Unix timestamp (in seconds) for when the vector store was created.

name

string

Required field. The name of the vector store.

usage_bytes

integer

Required field. The total number of bytes used by the files in the vector store.

file_counts

FileCounts

Required field.

status

enum

Required field. 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.

  • expired
  • in_progress
  • completed

expires_after

VectorStoreExpirationAfter

Required field. The expiration policy for a vector store.

expires_at

Any of integer | null

last_active_at

Any of integer | null

metadata

Any of object (map<string, string>) | null

FileCountsFileCounts

Field

Description

in_progress

integer

Required field. The number of files that are currently being processed.

completed

integer

Required field. The number of files that have been successfully processed.

failed

integer

Required field. The number of files that have failed to process.

cancelled

integer

Required field. The number of files that were cancelled.

total

integer

Required field. The total number of files.

VectorStoreExpirationAfterVectorStoreExpirationAfter

The expiration policy for a vector store.

Field

Description

anchor

enum

Required field. Anchor timestamp after which the expiration policy applies.
Supported anchors: last_active_at.''

  • last_active_at

days

integer

Required field. The number of days after the anchor time that the vector store will expire.

Was the article helpful?

Previous
createVectorStore
Next
modifyVectorStore
© 2026 Direct Cursus Technology L.L.C.