---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://yandex.com/support/appmetrica-io/en/mobile-api/push/get-groups.md
  - https://yandex.com/support/appmetrica-io/ru/mobile-api/push/get-groups.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/support/appmetrica-io/ru/llms.txt

# Получение списка групп

Возвращает все группы для заданного приложения.

## Формат запроса

```
GET https://push.api.appmetrica.yandex.net/push/v1/management/groups
  ? app_id=<string>
```

#|
||`app_id`* | Идентификатор (ID) приложения. ||
|#

## Формат ответа JSON

```json translate=no
{
  "groups" : [
    {
      "id": int,
      "app_id": int,
      "name": "string",
      "send_rate": int
    },
    ...
  ]
}
```

#|
|| `groups` | Информация о группах. ||
|| `groups.id` | Идентификатор (ID) группы. ||
|| `groups.app_id` | Идентификатор (ID) приложения. ||
|| `groups.name` | Уникальное название группы. ||
|| `groups.send_rate` | Ограничение на максимальную скорость отправки push-сообщений (количество в секунду).

Значение по умолчанию — 5000 (максимальное).

Минимально допустимое значение — 100.


{% note info %}

Уменьшение скорости отправки позволяет снизить нагрузку на ваш сервис.

{% endnote %}

||
|#

## Пример запроса {#example}

{% list tabs %}
 
- cURL

  ```bash translate=no
  curl -X GET \
    'https://push.api.appmetrica.yandex.net/push/v1/management/groups?app_id=XXXXXX' \
    -H 'Authorization: OAuth <your_token>'
  ```

  где `<your_token>` — это OAuth-токен, который можно получить по [инструкции](https://yandex.com/support/appmetrica-io/ru/mobile-api/intro/authorization.md#get-oauth-token).
 
- HTTP
 
  ```http translate=no
  GET /push/v1/management/groups?app_id=XXXXXX HTTP/1.1
  Host: push.api.appmetrica.yandex.net
  Authorization: OAuth <your_token>
  ```

  где `<your_token>` — это OAuth-токен, который можно получить по [инструкции](https://yandex.com/support/appmetrica-io/ru/mobile-api/intro/authorization.md#get-oauth-token).
 
{% endlist %}

<!-- source: ru/_includes/feedback-button-2.md -->
Если вы не нашли ответ на свой вопрос, то вы можете задать его через форму обратной связи. Пожалуйста, опишите возникшую проблему как можно подробнее. Если возможно, приложите скриншот.

<a href="../../troubleshooting/feedback-new">
  <span class="button">Написать в службу поддержки</span>
</a>

<a href="../../troubleshooting/feedback-docs">
  <span class="button">Предложить улучшение для документации</span>
</a>
<!-- endsource: ru/_includes/feedback-button-2.md -->