---
title: "Get Vector Backend Usage"
method: GET
path: "/v1/organizations/billing/usage/vector-backend"
tags: ["Organization Billing"]
---

# Get Vector Backend Usage

`GET /v1/organizations/billing/usage/vector-backend`

Get vector backend usage breakdown.

Returns usage dimensions (vectors stored, storage, queries, writes) and
cost breakdown for the tenant's active vector backend. Works for all
backends: qdrant, mvs, and dual_write.

**Requirements:**
- Read permission

## Query parameters

- `billing_month` string, nullable — Billing month in YYYY-MM format (defaults to current month)

## Response `200`

Successful Response

- VectorBackendUsageResponse — Response with vector backend usage details.
  - `vector_backend` string, required — Active vector backend for this tenant
  - `billing_month` string, required — Billing month (YYYY-MM)
  - `namespace_count` integer, required — Number of namespaces billed
  - `vectors_stored` integer, required — Total vectors stored across all namespaces
  - `storage_bytes` integer, required — Total storage bytes
  - `queries` integer, required — Total search queries in billing period
  - `writes` integer, required — Total writes in billing period
  - `cost_breakdown` VectorUsageBreakdown, required — Cost breakdown for vector backend usage.
    - `backend` string, required — Vector backend: qdrant, mvs, or dual_write
    - `vector_storage_usd` number, required — Raw cost for vector storage
    - `data_storage_usd` number, required — Raw cost for data storage (GCS/S3)
    - `query_usd` number, required — Raw cost for search queries
    - `write_usd` number, required — Raw cost for writes/upserts
    - `total_usd` number, required — Total cost after overhead and margin
    - `total_credits` integer, required — Total credits for vector backend usage
  - `total_credits` integer, required — Total credits for vector backend usage
  - `total_cost_usd` number, required — Total cost in USD

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/mixpeek/apis/mixpeek-api.md) · [All operations](https://skmtc.net/mixpeek/apis/mixpeek-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mixpeek/mixpeek-api/revisions/220a3b263fda/schema)