# Retrieve the full configuration details of a Email payload item

To get Email policy payload item

## Endpoint

**GET** `/api/v1/mdm/profiles/{profile_id}/payloads/emailpolicy/payloaditems/{payload_id}`

## Request URL

`https://{server-hostname}:8383/api/v1/mdm/profiles/{profile_id}/payloads/emailpolicy/payloaditems/{payload_id}`

## Scope

`MDMDeviceMgmt.READ`

## Header

`Authorization: d92d4xxxxxxxxxxxxx15f52`

## Request Parameters

### Request Headers

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

### Path Parameters

- **profile_id** `string` — **Mandatory**
  - Unique identifier of the profile. Obtain from the [Create Profile](https://www.manageengine.com/products/desktop-central/help/api/onpremise/mdm-profiles-create-profile.html) or [Get Profiles](https://www.manageengine.com/products/desktop-central/help/api/onpremise/mdm-profiles-get-profile.html) response.
- **payload_id** `string` — **Mandatory**
  - Unique identifier of the payload item. Obtain from the [Get Payload Item IDs](https://www.manageengine.com/products/desktop-central/help/api/onpremise/ios-get-email-payload-ios.html) response.

### Query Parameters

- **include** `string` — Optional
  - Comma-separated list of related fields to include in the response (e.g., assigned_to, payload_details). When omitted, only top-level fields are returned.

## Sample Request

```curl
curl --request GET \
  --url 'https://appdomain/api/v1/mdm/profiles/{profile_id}/payloads/emailpolicy/payloaditems/{payload_id}?include=payloaditems' \
  --header 'Accept: application/json' \
  --header 'Authorization:  d92d4xxxxxxxxxxxxx15f52'
```

## Response Parameters

### HTTP Code 200

Response Body — `application/json`

- **payload_id** `long`
  - Unique identifier of the payload item
- **account_name** `string`
  - Account Name
- **account_type** `string`
  - Account Type. Default: IMAP
- **account_path_prefix** `string`
  - Account Path Prefix
- **account_user_name** `string`
  - Account User Name
- **mail_address** `string`
  - Mail Address
- **allow_move** `boolean`
  - Allow Move. Default: true
- **prevent_move** `boolean`
  - Prevent Move. Default: false
- **disable_mail_recents_syncing** `boolean`
  - Disable Mail Recents Syncing. Default: false
- **incoming_server_hostname** `string`
  - Incoming Server Hostname
- **incoming_server_port** `integer`
  - Incoming Server Port. Default: 143
- **incoming_server_username** `string`
  - Incoming Server Username
- **incoming_server_auth** `string`
  - Incoming Server Auth. Allowed values: none, password, md5, ntlm, httpmd5. Default: password
- **incoming_password** `string`
  - Incoming Password (sensitive - write-only)
- **incoming_password_id** `long`
  - Incoming Password Id
- **incoming_server_use_ssl** `boolean`
  - Incoming Server Use Ssl. Default: false
- **outgoing_server_hostname** `string`
  - Outgoing Server Hostname
- **outgoing_server_port** `integer`
  - Outgoing Server Port. Default: 587
- **outgoing_server_username** `string`
  - Outgoing Server Username
- **outgoing_server_auth** `string`
  - Outgoing Server Auth. Allowed values: none, password, md5, ntlm, httpmd5. Default: password
- **outgoing_password** `string`
  - Outgoing Password (sensitive - write-only)
- **outgoing_password_id** `long`
  - Outgoing Password Id
- **outgoing_pwd_as_income_pwd** `boolean`
  - Outgoing Pwd As Income Pwd. Default: false
- **use_only_mail_app** `boolean`
  - Use Only Mail App. Default: false
- **outgoing_server_use_ssl** `boolean`
  - Outgoing Server Use Ssl. Default: false
- **use_mime_encrypt** `boolean`
  - Use Mime Encrypt. Default: false
- **signing_cert_id** `long`
  - Signing identity certificate ID obtained from the [Certificates API](https://www.manageengine.com/products/desktop-central/help/api/onpremise/certificates-get-certificates.html).
- **encryption_cert_id** `long`
  - Encryption identity certificate ID obtained from the [Certificates API](https://www.manageengine.com/products/desktop-central/help/api/onpremise/certificates-get-certificates.html).

## Possible Response Codes

- **200** `HTTP code`

## Sample Response: HTTP 200

Full configuration details of Email payload item

```json
{
  "prevent_move": false,
  "payload_id": 9007199254741000,
  "account_type": "IMAP",
  "disable_mail_recents_syncing": false,
  "incoming_server_username": "user@zylker.com",
  "outgoing_server_username": "user@zylker.com",
  "allow_move": true,
  "incoming_server_hostname": "https://zylker.com",
  "outgoing_server_hostname": "smtp.zylker.com",
  "account_user_name": "Zylker User",
  "account_path_prefix": "value",
  "account_name": "Zylker User",
  "incoming_server_auth": "password",
  "mail_address": "user@zylker.com",
  "outgoing_server_auth": "password",
  "incoming_server_port": 143
}
```

## API Rate Limits

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

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