# Retrieve the full configuration details of a Email payload item

Get Android Email policy payload

## Endpoints

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

## Request URL

`https://[{serverurl}](https://www.manageengine.com/mobile-device-management/help/api/cloud/oauth-authentication-endpoint-domain.html)/api/v1/mdm/profiles/{profile_id}/payloads/androidemailpolicy/payloaditems/{payload_id}`

## Scope

`MDMOnDemand.MDMDeviceMgmt.READ`

## Header

`Authorization: Zoho-oauthtoken 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/mobile-device-management/help/api/cloud/profiles-create-profile.html) or [Get Profiles](https://www.manageengine.com/mobile-device-management/help/api/cloud/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/mobile-device-management/help/api/cloud/android-get-email-payload-android.html) response.

## Sample Request

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

## Response Parameters

### HTTP Code 200

Response Body — `application/json`

`JSON object`

- **payload_id** `long`
  - Unique identifier of the payload item
- **account_name** `string`
  - Display name for the email account, shown on the device
- **account_type** `integer`
  - Email protocol type. 1 = IMAP, 2 = POP3. Default: 1
- **mail_address** `string`
  - Email address for this account. Use `%email%` to auto-populate from the enrolled user
- **sender_name** `string`
  - Name shown as the sender in outgoing emails. Use `%username%` to auto-populate
- **allow_html_content** `boolean`
  - Allow rendering of HTML-formatted email content on the device. Default: true
- **allow_forward** `boolean`
  - Allow the user to forward received emails. Default: true
- **allow_notify** `boolean`
  - Enable email push notifications on the device. Default: true
- **allow_vibrate_on_silent** `boolean`
  - Enable vibration for email notifications when the device is on silent mode. Default: true
- **default_account** `boolean`
  - Set this as the default email account on the device. Default: false
- **allow_change_setting** `boolean`
  - Allow the user to modify email account settings from the device. Default: true
- **signature** `string`
  - Default signature appended to outgoing emails
- **incoming_protocol** `string`
  - Protocol for the incoming mail server. Typically IMAP or POP3
- **incoming_server_hostname** `string`
  - Hostname or IP address of the incoming mail server (required)
- **incoming_server_port** `integer`
  - Port for the incoming mail server. Common values: 993 (IMAP+SSL), 143 (IMAP), 995 (POP3+SSL), 110 (POP3). Default: 143
- **incoming_user_name** `string`
  - Username for authenticating to the incoming mail server. Use `%username%` to auto-populate
- **incoming_server_password** `string`
  - Password for the incoming mail server. Write-only; not returned in responses
- **incoming_server_password_id** `long`
  - ID of a stored credential used as the incoming mail server password. Use -1 when providing password directly
- **incoming_server_use_ssl** `boolean`
  - Enable SSL/TLS encryption for the incoming mail server connection. Default: true
- **incoming_server_use_tls** `boolean`
  - Enable STARTTLS encryption upgrade for the incoming mail server connection. Default: false
- **incoming_server_certificate** `boolean`
  - Require a trusted certificate from the incoming mail server. Default: true
- **outgoing_protocol** `string`
  - Protocol for the outgoing mail server. Typically SMTP. Default: SMTP
- **outgoing_server_hostname** `string`
  - Hostname or IP address of the outgoing (SMTP) mail server (required)
- **outgoing_server_port** `integer`
  - Port for the outgoing mail server. Common values: 465 (SMTP+SSL), 587 (SMTP+TLS), 25 (SMTP). Default: 587
- **outgoing_user_name** `string`
  - Username for authenticating to the outgoing mail server. Use `%username%` to auto-populate
- **outgoing_server_password** `string`
  - Password for the outgoing mail server. Write-only; not returned in responses
- **outgoing_server_password_id** `long`
  - ID of a stored credential used as the outgoing mail server password. Use -1 when providing password directly
- **outgoing_server_use_ssl** `boolean`
  - Enable SSL/TLS encryption for the outgoing mail server connection. Default: true
- **outgoing_server_use_tls** `boolean`
  - Enable STARTTLS encryption upgrade for the outgoing mail server connection. Default: false
- **outgoing_server_certificate** `boolean`
  - Require a trusted certificate from the outgoing mail server. Default: true

## Possible Response Codes

- **200** — HTTP code

## Sample Response: HTTP 200

Full configuration details of Email payload item

```json
{
  "account_type": 1,
  "signature": "Regards, %username%",
  "outgoing_server_password_id": -1,
  "sender_name": "%username%",
  "default_account": false,
  "outgoing_server_use_tls": false,
  "outgoing_user_name": "%username%",
  "incoming_protocol": "IMAP",
  "account_name": "Corporate Email",
  "allow_html_content": true,
  "allow_change_setting": true,
  "outgoing_server_port": 587,
  "incoming_server_certificate": false,
  "mail_address": "%email%",
  "incoming_server_port": 993,
  "outgoing_server_use_ssl": true,
  "payload_id": 9007199254741000,
  "allow_forward": true,
  "incoming_server_hostname": "imap.zylker.com",
  "incoming_server_password_id": -1,
  "outgoing_server_hostname": "smtp.zylker.com",
  "allow_notify": true,
  "incoming_server_use_tls": false,
  "outgoing_protocol": "SMTP",
  "allow_vibrate_on_silent": true,
  "incoming_user_name": "%username%",
  "incoming_server_use_ssl": true,
  "outgoing_server_certificate": false
}
```

## Rate Limits

![](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.