---
title: "POST /getStickerSet"
method: POST
path: "/getStickerSet"
---

# POST /getStickerSet

`POST /getStickerSet`

Use this method to get a sticker set. On success, a [StickerSet](https://core.telegram.org/bots/api/#stickerset) object is returned.

## Request body

- object
  - `name` string, required — Name of the sticker set

## Response `200`

- object
  - `ok` boolean, required
  - `result` StickerSet, required — This object represents a sticker set.
    - `name` string, required — Sticker set name
    - `title` string, required — Sticker set title
    - `is_animated` boolean, required — *True*, if the sticker set contains [animated stickers](https://telegram.org/blog/animated-stickers)
    - `contains_masks` boolean, required — *True*, if the sticker set contains masks
    - `stickers` Sticker[], required — List of all set stickers
      - `file_id` string, required — Identifier for this file, which can be used to download or reuse the file
      - `file_unique_id` string, required — Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.
      - `width` integer, required — Sticker width
      - `height` integer, required — Sticker height
      - `is_animated` boolean, required — *True*, if the sticker is [animated](https://telegram.org/blog/animated-stickers)
      - `thumb` PhotoSize — This object represents one size of a photo or a [file](https://core.telegram.org/bots/api/#document) / [sticker](https://core.telegram.org/bots/api/#sticker) thumbnail.
        - `file_id` string, required — Identifier for this file, which can be used to download or reuse the file
        - `file_unique_id` string, required — Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.
        - `width` integer, required — Photo width
        - `height` integer, required — Photo height
        - `file_size` integer — *Optional*. File size
      - `emoji` string — *Optional*. Emoji associated with the sticker
      - `set_name` string — *Optional*. Name of the sticker set to which the sticker belongs
      - `mask_position` MaskPosition — This object describes the position on faces where a mask should be placed by default.
        - `point` 'forehead' | 'eyes' | 'mouth' | 'chin', required — The part of the face relative to which the mask should be placed. One of “forehead”, “eyes”, “mouth”, or “chin”.
        - `x_shift` number, required — Shift by X-axis measured in widths of the mask scaled to the face size, from left to right. For example, choosing -1.0 will place mask just to the left of the default mask position.
        - `y_shift` number, required — Shift by Y-axis measured in heights of the mask scaled to the face size, from top to bottom. For example, 1.0 will place the mask just below the default mask position.
        - `scale` number, required — Mask scaling coefficient. For example, 2.0 means double size.
      - `file_size` integer — *Optional*. File size
    - `thumb` PhotoSize — This object represents one size of a photo or a [file](https://core.telegram.org/bots/api/#document) / [sticker](https://core.telegram.org/bots/api/#sticker) thumbnail.
      - `file_id` string, required — Identifier for this file, which can be used to download or reuse the file
      - `file_unique_id` string, required — Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.
      - `width` integer, required — Photo width
      - `height` integer, required — Photo height
      - `file_size` integer — *Optional*. File size

## Other responses

- `default`

---

[API](https://skmtc.net/stoplight/apis/telegram-bot-api.md) · [All operations](https://skmtc.net/stoplight/apis/telegram-bot-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stoplight/telegram-bot-api/versions/be4bbb34b64a/schema)