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
  1. API references
  2. OpenAI-compatible APIs
  3. Vector stores
  4. getVectorStoreFileBatch

REST: Retrieve vector store file batch

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

Retrieves a vector store file batch.

HTTP requestHTTP request

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

Path parametersPath parameters

Field

Description

vector_store_id

string

Required field. The ID of the vector store that the file batch belongs to.

batch_id

string

Required field. The ID of the file batch being retrieved.

ResponseResponse

HTTP Code: 200

OK

Response schema: application/json

{
  "id": "string",
  "object": "string",
  "created_at": "integer",
  "vector_store_id": "string",
  "status": "string",
  "file_counts": {
    "in_progress": "integer",
    "completed": "integer",
    "failed": "integer",
    "cancelled": "integer",
    "total": "integer"
  }
}

A batch of files attached to a vector store.

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.file_batch.

  • vector_store.files_batch

created_at

integer

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

vector_store_id

string

Required field. The ID of the vector store that the file is attached to.

status

enum

Required field. The status of the vector store files batch, which can be either in_progress, completed, cancelled or failed.

  • in_progress
  • completed
  • cancelled
  • failed

file_counts

FileCounts

Required field.

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 processed.

failed

integer

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

cancelled

integer

Required field. The number of files that where cancelled.

total

integer

Required field. The total number of files.

Was the article helpful?

Previous
createVectorStoreFileBatch
Next
listFilesInVectorStoreBatch
© 2026 Direct Cursus Technology L.L.C.