---
title: "List Shops"
method: GET
path: "/shops"
tags: ["Methods"]
---

# List Shops

`GET /shops`

Returns the authenticated user's active shops, ordered by creation (oldest first). Inactive shops are never listed. Single-shop owners always see one element; multi-shop owners use this endpoint to discover shop IDs to pass to the other shop endpoints via `?shopId=`.

## Response `200`

Successful response

- Shop[]
  - `id` integer, required — Shop ID
  - `userId` integer, required — Shop owner user ID
  - `name` string, required — Shop name
  - `link` string, required — Shop link/slug
  - `callbackUrl` string, uri, required — Webhook callback URL for order notifications
  - `recurrent` boolean, required — Whether recurring payments are available
  - `onlyStars` boolean, required — Whether only Telegram Stars payment is accepted
  - `tokenCharging` boolean, required — Whether merchant-initiated token charging is enabled
  - `status` 0 | 1, required — Shop status (0 = inactive, 1 = active)

## Other responses

- `401` — Unauthorized (invalid API key)

---

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