# Get Index Stats

> Retrieves statistics and metrics for a specific search index

## Endpoint

`GET https://api.upstash.com/v2/search/{id}/stats`

## Parameters

- `id` (path, string, required): The ID of the search index
- `period` (query, enum<string>): Time period for statistics aggregation. Each period returns 60 datapoints 
with intervals adjusted to the period length. 

Exceptionally for 30 days, it returns 240 datapoints with 3-hour intervals for increased granularity.


## Responses

### 200 - Statistics for the specified search index retrieved successfully

- `pending_index_count` (integer): Number of pending index operations
- `current_vector_count` (integer): Current number of vectors in the index
- `daily_query_count` (integer): Total number of query operations executed today
- `daily_update_count` (integer): Total number of update operations executed today
- `monthly_query_count` (integer): Total query operations in current month
- `monthly_update_count` (integer): Total update operations in current month
- `monthly_bandwidth_usage` (integer): Total bandwidth used in current month (bytes)
- `storage_usage` (integer): Current storage used (bytes)
- `monthly_cost` (number): Total cost in current month
- `daily_update_requests` (object[]): Daily update requests over time
  - `x` (string): Timestamp when measurement was taken
  - `y` (number): The measured value
- `daily_query_requests` (object[]): Daily query requests over time
  - `x` (string): Timestamp when measurement was taken
  - `y` (number): The measured value
- `daily_bandwidths` (object[]): Daily bandwidth usage over time
  - `x` (string): Timestamp when measurement was taken
  - `y` (number): The measured value
- `days` (string[]): Days of the week for measurement
- `query_throughput` (object[]): Query throughput over time
  - `x` (string): Timestamp when measurement was taken
  - `y` (number): The measured value
- `update_throughput` (object[]): Update throughput over time
  - `x` (string): Timestamp when measurement was taken
  - `y` (number): The measured value
- `query_latency_mean` (object[]): Average query latency over time
  - `x` (string): Timestamp when measurement was taken
  - `y` (number): The measured value
- `query_latency_99` (object[]): 99th percentile query latency over time
  - `x` (string): Timestamp when measurement was taken
  - `y` (number): The measured value
- `update_latency_mean` (object[]): Average update latency over time
  - `x` (string): Timestamp when measurement was taken
  - `y` (number): The measured value
- `update_latency_99` (object[]): 99th percentile update latency over time
  - `x` (string): Timestamp when measurement was taken
  - `y` (number): The measured value
- `embeds_latency_mean` (object[]): Average embedding latency over time
  - `x` (string): Timestamp when measurement was taken
  - `y` (number): The measured value
- `embeds_latency_99` (object[]): 99th percentile embedding latency over time
  - `x` (string): Timestamp when measurement was taken
  - `y` (number): The measured value
- `vector_count` (object[]): Vector count over time
  - `x` (string): Timestamp when measurement was taken
  - `y` (number): The measured value
- `data_size` (object[]): Data size over time
  - `x` (string): Timestamp when measurement was taken
  - `y` (number): The measured value
- `daily_rerank_count` (integer): Total number of rerank operations executed today
- `monthly_rerank_count` (integer): Total rerank operations in current month
- `daily_rerank_requests` (object[]): Daily rerank requests over time
  - `x` (string): Timestamp when measurement was taken
  - `y` (number): The measured value
- `rerank_latency_mean` (object[]): Average rerank latency over time
  - `x` (string): Timestamp when measurement was taken
  - `y` (number): The measured value
- `rerank_latency_99` (object[]): 99th percentile rerank latency over time
  - `x` (string): Timestamp when measurement was taken
  - `y` (number): The measured value

## cURL

```bash
curl --request GET \
  --url https://api.upstash.com/v2/search/{id}/stats \
  --header 'Authorization: Bearer <token>'
```