# Fetches the list of supported template packages

Retrieves a paginated list of template packages available for creation, filtered by platform and optional search text. The packageId in the response represents the patchId needed for other template APIs.

## Endpoints

[GET /dcapi/swDeployment/templatePackageList](https://www.manageengine.com/products/desktop-central/help/api/cloud/templates-list-template-packages.html)

## Request URL

`https://[{serverurl}](https://www.manageengine.com/products/desktop-central/help/api/cloud/oauth-authentication-endpoint-domain.html)/dcapi/swDeployment/templatePackageList`

## Scope

`DesktopCentralCloud.SWDeployment.READ`

## Header

`Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52`

## Request Parameters

### Request Headers

- **Accept** `string` — **Mandatory**
  - `application/templatePackageList.v1+json`

### Query Parameters

- **platform** `string` — **Mandatory**
  - Required. Target platform filter: windows or mac.
- **startIndex** `integer` — Optional
  - Zero-based starting index. Defaults to 0.
- **limit** `integer` — Optional
  - Maximum number of records per page. Defaults to 30. Maximum allowed value: 1000.
- **searchValue** `string` — Optional
  - Optional search string to filter template packages by name.

## Sample Request

```curl
curl --request GET \
  --url 'https://appdomains/dcapi/swDeployment/templatePackageList?platform=SOME_STRING_VALUE' \
  --header 'Accept: application/templatePackageList.v1+json' \
  --header 'Authorization: Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52'
```

## Response Parameters

### HTTP Code 200

#### Response Body: `application/json`

`JSON Object`

- **packageName** `string`
  - Display name of the template package
- **packageId** `string`
  - Template patch identifier (patchId). Use this value as the patchId parameter when calling the [Get Template Package Details](https://www.manageengine.com/products/desktop-central/help/api/cloud/templates-get-template-package-details.html) API.
- **softwareId** `string`
  - Software identifier from the PPM crawler database
- **softwareName** `string`
  - Display name of the software

### HTTP Code 500

#### Response Body: `application/json`

`JSON Object`

- **errorCode** `string`
  - INTERNAL_ERROR for general failures, SW_INTERNAL_ERROR for software deployment internal errors
- **errorMessage** `string`
  - Internal server error with details about the template/auto-update operation failure

## Possible Response Codes

- **200** — HTTP code
- **500** — HTTP code

## Sample Response: HTTP 200

Windows template packages

```json
[
  {
    "softwareId": "2001",
    "softwareName": "7-Zip",
    "packageId": "50001",
    "packageName": "7-Zip 23.01 x64"
  },
  {
    "softwareId": "2002",
    "softwareName": "Google Chrome",
    "packageId": "50002",
    "packageName": "Google Chrome 120.0"
  }
]
```

## Sample Response: HTTP 500

Server error

```json
{
  "errorMessage": "Internal Server Error",
  "errorCode": "INTERNAL_ERROR"
}
```

## Rate Limit

![](https://www.zohowebstatic.com/sites/zweb/images/people/ico-help.png)

**Duration:** 1 minute | **Threshold:** 100 | **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.