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

# Category list

Returns a list of all app categories.

## Request format {#request-format}

```
GET https://api.appmetrica.yandex.com/management/v1/metadata/application/categories
  ? [lang=<locale>]
```

#|
|| `lang` | Response localization.

Possible values:
- ru — The response is in Russian;
- en — The response is in English. ||
   |#

## Response format {#response-body}

```json translate=no
{
  "data": [
    {
      "id": int,
      "name": "string",
      "type": "string"
    },
    ...
  ]
}
```
#|
|| `data` | An object that contains information about categories. ||
|| `data.id` | ID of the category. ||
|| `data.name` | Name of the category.

To get the category name in English, add the parameter `lang=en` to the request. ||
|| `data.type` | Type of category.

Possible values:
- game — Games category.
- common — Common category. ||
   |#

## Example {#example}

{% list tabs %}

- cURL

   ```bash translate=no
   curl -X GET \
     'https://api.appmetrica.yandex.com/management/v1/metadata/application/categories?lang=en' \
     -H 'Authorization: OAuth <your_token>'
   ```

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

- HTTP

   ```http translate=no
   GET /management/v1/metadata/application/categories?lang=en HTTP/1.1
   Host: api.appmetrica.yandex.com
   Authorization: OAuth <your_token>
   ```

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

{% endlist %}

<!-- source: en/_includes/feedback-button-3.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-3.md -->