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

# List of groups

Returns all groups for the specified application.

## Request format

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

#|
||`app_id`* | App ID. ||
|#

## Response format (JSON)

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

#|
|| `groups` | Information about groups. ||
|| `groups.id` | Group ID. ||
|| `groups.app_id` | App ID. ||
|| `groups.name` | Unique name of the group. ||
|| `groups.send_rate` | Dispatch speed limit for push messages (messages per second).

The default value is 5000 (maximum).

The minimum value is 100.


{% note info %}

Reducing the speed allows you to decrease your handling service load.

{% endnote %}

||
|#

## Sample request {#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>'
   ```

   where `<your_token>` is an OAuth token that can be obtained using [instructions](https://appmetrica.yandex.com.tr/docs/en/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>
   ```

   where `<your_token>` is an OAuth token that can be obtained using [instructions](https://appmetrica.yandex.com.tr/docs/en/mobile-api/intro/authorization.md#get-oauth-token).

{% endlist %}

<!-- source: en/_includes/feedback-button-2.md -->
If you didn't find the answer you were looking for, you can use the feedback form to submit your question. Please describe the problem in as much detail as possible. Attach a screenshot if possible.

<a href="../../troubleshooting/feedback-new">
  <span class="button">Contact support</span>
</a>

<a href="../../troubleshooting/feedback-docs">
  <span class="button">Suggest an improvement for documentation</span>
</a>
<!-- endsource: en/_includes/feedback-button-2.md -->