# Retrieve a list of all apps in the App Repository

Get app list from repository

## Endpoint

`GET /api/v1/mdm/apps`

## Request URL

`https://{server-hostname}:8383/api/v1/mdm/apps`

## Scope

`MDMDeviceMgmt.READ`

## Header

`Authorization: d92d4xxxxxxxxxxxxx15f52`

## Request Parameters

### Request Headers

- **Accept** `string` — **Mandatory**: `application/json`

### Query Parameters

- **limit** `integer` — Optional

  Maximum number of records to return in a single response. Used together with offset for pagination

- **skip-token** `string` — Optional

  Pagination continuation token returned by a previous response. Pass it to fetch the next page of results

- **offset** `integer` — Optional

  Zero-based index of the first record to return. Used together with limit for pagination

- **delta-token** `string` — Optional

  Token used for delta/incremental fetches. Pass the token returned from a previous response to retrieve only items modified since that point

- **search** `string` — Optional

  Free-text search string applied to the default searchable fields of the resource

- **platform** `string` — Optional

  Filter results by device platform. Allowed values: 1=iOS, 2=Android, 3=Windows, 4=macOS, 6=tvOS

- **ispaidapp** `boolean` — Optional

- **isbusinessapp** `boolean` — Optional

- **isenterpriseapp** `boolean` — Optional

- **businessstore_id** `long` — Optional

  Unique identifier of the Business Store (Apple VPP / Managed Google Play / Microsoft Store) to scope the request to

## Sample Request

```curl
curl --request GET \
  --url 'https://appdomain/api/v1/mdm/apps?limit=SOME_INTEGER_VALUE&skip-token=SOME_STRING_VALUE&offset=SOME_INTEGER_VALUE&delta-token=SOME_STRING_VALUE&search=SOME_STRING_VALUE&platform=SOME_STRING_VALUE&ispaidapp=SOME_BOOLEAN_VALUE&isbusinessapp=SOME_BOOLEAN_VALUE&isenterpriseapp=SOME_BOOLEAN_VALUE&businessstore_id=SOME_INTEGER_VALUE' \
  --header 'Accept: application/json' \
  --header 'Authorization:  d92d4xxxxxxxxxxxxx15f52'
```

## Response Parameters

### HTTP Code 200

Response Body — `application/json`

- `JSON Object`
  - **apps** `JSON Array`

    Array of app objects in the App Repository

### Possible Response Codes

- **200** `HTTP code`

## Sample Response: HTTP 200

### List of apps in the repository with release label version details

```json
{
  "apps": [
    {
      "app_name": "Zylker MDM",
      "app_type": 2,
      "added_time": 1714630800000,
      "modified_time": 1714717200000,
      "platform_type": 2,
      "icon": "https://appDomain/mdm-logo.png",
      "description": "The is an enterprise app",
      "app_category": "Education",
      "app_id": 9007199254741080,
      "version": "1.1.1",
      "release_labels": [
        {
          "release_label_type": 1,
          "app_version": "12.3.45",
          "release_label_name": "Stable",
          "release_label_id": 9007199254741076
        }
      ]
    }
  ]
}
```

### No apps found in the repository

```json
{
  "apps": []
}
```

## Rate Limit

**Duration:** 1 minute | **Threshold:** 60 | **Lock period:** 5 minutes

Duration - Time window for the threshold.
Threshold - Number of API calls allowed within the specified duration.
Lock Period - Wait time before consecutive API requests.