---
title: "Get Store"
method: GET
path: "/v1/stores/{store_id}"
tags: ["Stores"]
---

# Get Store

`GET /v1/stores/{store_id}`

## Path parameters

- `store_id` string, required

## Response `200`

Successful Response

- StoreRead
  - `name` string, required — The name of the store, used for display purposes.
  - `description` string, required — The description of the store, such as its purpose, features, or additional details.
  - `key` string, nullable — The key of the store.
  - `type` 'default' | 'special' | 'rotation' | 'limited_stock' | 'webhook', required — An enumeration.
  - `rotation_settings` RotationSettings
    - `count` integer, required — Number of items to take for each rotation
    - `period_value` integer, required
    - `period_type` 'year' | 'month' | 'week' | 'day' | 'hour' | 'minute' | 'second', required
    - `type` 'random' | 'random_by_weight' | 'round_robin', required — An enumeration.
    - `show_timer` boolean, nullable — Determines whether to show the timer until the next rotation
    - `global_rotation` boolean, nullable — Whether the rotation is global or per user.
    - `last_global_rotated_at` integer, nullable — Last global rotation timestamp
    - `current_rotated_store_item_ids` string[], nullable — Current visible store item ids
  - `limited_stock_settings` LimitedStockSettings
    - `total_quantity` integer, required
    - `type` 'emulating_remainder' | 'real_remainder', required — An enumeration.
    - `start_calculation_at` integer, nullable
  - `start_at` integer, nullable — The start time of the store in Unix timestamp (seconds) when it becomes available to users.
  - `end_at` integer, nullable — The end time of the store in Unix timestamp (seconds) when it closes and is no longer accessible.
  - `settings` StoreSettings
    - `webhook_settings` StoreWebhookSettings
      - `webhook_id` string, required
      - `cache_period_type` 'year' | 'month' | 'week' | 'day' | 'hour' | 'minute' | 'second'
      - `cache_period_value` integer
  - `id` string, required
  - `current_purchase_count` integer

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/aghanim/apis/aghanim-server-to-server-api.md) · [All operations](https://skmtc.net/aghanim/apis/aghanim-server-to-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aghanim/aghanim-server-to-server-api/versions/6402c25762c8/schema)