# Retrieve the full configuration details of a Restrictions payload item Get Android Restriction policy payload ## Endpoint `GET /api/v1/mdm/profiles/{profile_id}/payloads/androidrestrictionspolicy/payloaditems/{payload_id}` ## Request URL `https://{serverurl}/api/v1/mdm/profiles/{profile_id}/payloads/androidrestrictionspolicy/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-restrictions-payload-android.html) response. ## Sample Request ```curl curl --request GET \ --url https://appdomain/api/v1/mdm/profiles/{profile_id}/payloads/androidrestrictionspolicy/payloaditems/{payload_id} \ --header 'Accept: application/json' \ --header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' ``` ## Response Parameters ### HTTP Code 200 Response body: `application/json` - **payload_id** (`long`): Unique identifier of the payload item. - **allow_non_market_app_instal** (`integer`): Whether installing apps from non-market sources is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_disabling_cellular_data** (`integer`): Whether disabling cellular data is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_app_auto_sync** (`integer`): Whether app auto-sync is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_data_while_roaming** (`integer`): Whether data usage while roaming is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_background_data** (`integer`): Whether background data usage is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_bluetooth** (`integer`): Whether Bluetooth is allowed. `0` = Restricted, `1` = Allowed, `4` = User Controlled. Default: `4`. - **allow_usb** (`integer`): Whether USB connectivity is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_camera** (`integer`): Whether the camera is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_storage_encryption** (`integer`): Whether storage encryption enforcement is configured. `0` = Allow encryption, `1` = Disable encryption, `2` = Not Configured. Default: `2`. - **external_storage_encryption** (`integer`): Whether external storage encryption is required. `0` = Not Required, `1` = Required, `2` = Not Configured. Default: `2`. - **allow_nfc** (`integer`): Whether NFC is allowed. `0` = Restricted, `1` = Allowed, `4` = User Controlled. Default: `4`. - **allow_disabling_gps** (`integer`): Whether disabling GPS is allowed. `0` = Restricted, `1` = Allowed, `4` = User Controlled. Default: `4`. - **allow_microphone** (`integer`): Whether the microphone is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_bluetooth_tethering** (`integer`): Whether Bluetooth tethering is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_wifi** (`integer`): Whether Wi-Fi is allowed. `0` = Restricted, `1` = Allowed, `4` = User Controlled. Default: `4`. - **allow_whitelist_wifi_only** (`integer`): Whether only allowlisted Wi-Fi networks are permitted. `0` = All networks allowed, `1` = Allowlisted only. Default: `0`. - **allow_wifi_tethering** (`integer`): Whether Wi-Fi tethering (hotspot) is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_usb_tethering** (`integer`): Whether USB tethering is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_tethering** (`integer`): Whether tethering is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_usb_debug** (`integer`): Whether USB debugging is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_sd_card** (`integer`): Whether SD card access is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_sd_card_write** (`integer`): Whether writing to SD card is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_clipboard** (`integer`): Whether clipboard access is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_google_crash_report** (`integer`): Whether Google crash reports are allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_mock_location** (`integer`): Whether mock locations are allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_settings** (`integer`): Whether access to device settings is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_factory_reset** (`integer`): Whether factory reset is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_wallpaper_change** (`integer`): Whether wallpaper changes are allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_statusbar_expansion** (`integer`): Whether status bar expansion is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_ota_upgrade** (`integer`): Whether OTA upgrades are allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_vpn** (`integer`): Whether VPN is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_screen_capture** (`integer`): Whether screen capture is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_power_off** (`integer`): Whether powering off the device is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_usb_media_player** (`integer`): Whether USB media player is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_android_market** (`integer`): Whether the Android Market (Play Store) is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_non_market_apps** (`integer`): Whether non-market apps are allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_personal_space_non_market_apps** (`integer`): Whether non-market apps in personal space are allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_you_tube** (`integer`): Whether YouTube is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_voice_dialer** (`integer`): Whether the voice dialer is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_install_app** (`integer`): Whether app installation is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_uninstall_app** (`integer`): Whether app uninstallation is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_android_browser** (`integer`): Whether the Android browser is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **browser_allow_fraud_warning** (`integer`): Whether browser fraud warnings are allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **browser_allow_popups** (`integer`): Whether browser popups are allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **browser_allow_javascript** (`integer`): Whether browser JavaScript is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **browser_allow_autofill** (`integer`): Whether browser autofill is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **browser_allow_cookies** (`integer`): Whether browser cookies are allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_roaming_sync** (`integer`): Whether sync while roaming is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_roaming_voice_calls** (`integer`): Whether voice calls while roaming are allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_roaming_push** (`integer`): Whether push notifications while roaming are allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_roaming_data** (`integer`): Whether data usage while roaming is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_s_voice** (`integer`): Whether S Voice is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_stop_system_app** (`integer`): Whether stopping system apps is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **disable_clear_storage_and_force_stop_apps** (`JSON array`): List of apps excluded from clear storage and force stop restrictions. - **allow_app_control** (`integer`): Whether app control restrictions are enabled. `0` = Disabled, `1` = Enabled. Default: `1`. - **allow_clear_app_data_and_force_stop** (`integer`): Whether clearing app data and force stopping apps is allowed. `0` = Restricted, `1` = Allowed, `2` = Restrict Specific Apps. Default: `1`. - **allow_airplane_mode** (`integer`): Whether airplane mode is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_android_beam** (`integer`): Whether Android Beam is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_background_process_limit** (`integer`): Whether background process limit is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_s_beam** (`integer`): Whether S Beam is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_wifi_direct** (`integer`): Whether Wi-Fi Direct is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_headphone** (`integer`): Whether headphone use is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_smart_clip_mode** (`integer`): Whether Smart Clip mode is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_clipboard_share** (`integer`): Whether clipboard sharing is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_firmware_recovery** (`integer`): Whether firmware recovery is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_sdcard_move** (`integer`): Whether moving apps to SD card is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_safe_mode** (`integer`): Whether safe mode is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_home_key** (`integer`): Whether the home key is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_lock_screen_menu** (`integer`): Whether the lock screen menu is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_developer_mode** (`integer`): Whether developer mode is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_kill_activity_on_leave** (`integer`): Whether killing activities on leave is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_lock_screen_view** (`integer`): Whether the lock screen view is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_share_list** (`integer`): Whether the share list is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_play_protect_monitoring** (`integer`): Whether Google Play Protect monitoring is allowed. `0` = Restricted, `1` = Allowed. Default: `0`. - **allow_user_mobile_data_limit** (`integer`): Whether the user can set mobile data limits. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_date_time_change** (`integer`): Whether changing date and time is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_google_account_auto_sync** (`integer`): Whether Google account auto-sync is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_user_profile** (`integer`): Whether user profiles are allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_app_notification_mode** (`integer`): Whether app notification mode changes are allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_audio_record** (`integer`): Whether audio recording is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_video_record** (`integer`): Whether video recording is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_usb_host_storage** (`integer`): Whether USB host storage is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_use_network_time** (`integer`): Whether using network time is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_gmail** (`integer`): Whether Gmail is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_google_maps** (`integer`): Whether Google Maps is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_bt_discoverable** (`integer`): Whether Bluetooth discoverable mode is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_bt_pairing** (`integer`): Whether Bluetooth pairing is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_bt_outgoing_calls** (`integer`): Whether Bluetooth outgoing calls are allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_bt_pc_connection** (`integer`): Whether Bluetooth PC connections are allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_bt_data_transfer** (`integer`): Whether Bluetooth data transfer is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_emergency_calls_only** (`integer`): Whether emergency calls only mode is enforced. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_mms** (`integer`): Whether MMS is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_incoming_mms** (`integer`): Whether incoming MMS is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_outgoing_mms** (`integer`): Whether outgoing MMS is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_sms** (`integer`): Whether SMS is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_incoming_sms** (`integer`): Whether incoming SMS is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_outgoing_sms** (`integer`): Whether outgoing SMS is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_call** (`integer`): Whether phone calls are allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_outgoing_call** (`integer`): Whether outgoing calls are allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_incoming_call** (`integer`): Whether incoming calls are allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_user_add_accounts** (`integer`): Whether the user can add accounts. `0` = Restricted, `1` = Allowed. Default: `1`. - **restricted_account_types** (`JSON array`): List of restricted account type identifiers. - **allow_personal_accounts_in_playstore** (`boolean`): Whether personal accounts are allowed in the Play Store. Default: `true`. - **allow_s_finder** (`integer`): Whether S Finder is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_air_command** (`integer`): Whether Air Command is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_air_view** (`integer`): Whether Air View is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **app_permission_policy** (`integer`): Global runtime permission policy. `0` = Prompt, `1` = Auto Grant, `2` = Auto Deny, `4` = Not Configured. Default: `4`. - **allow_timezone** (`string`): Timezone identifier to enforce (for example, `America/New_York`). Empty = User Controlled. - **allow_ambient_display** (`boolean`): Whether ambient display (always-on display) is enabled. Default: `true`. - **allow_brightness_config** (`boolean`): Whether the user can configure screen brightness. Default: `true`. - **adaptive_brightness** (`boolean`): Whether adaptive brightness is enabled. Default: `true`. - **brightness_value** (`integer`): Screen brightness level (`0`-`255`). Default: `126`. - **allow_date_time_settings** (`boolean`): Whether the user can change date and time settings. Default: `true`. - **allow_config_screen_timeout** (`boolean`): Whether the user can configure screen timeout. Default: `true`. - **screen_timeout** (`integer`): Screen timeout duration in seconds. Default: `5`. - **allow_printing** (`boolean`): Whether printing is allowed. Default: `true`. - **allow_non_secure_keypad** (`integer`): Whether the non-secure keypad is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_contact_to_device** (`integer`): Whether contact sync to device is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_knox_app_store** (`integer`): Whether the Knox App Store is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_keyguard_camera** (`integer`): Whether the keyguard camera is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_keyguard_notifications** (`integer`): Keyguard notification visibility level. `0` = Show All, `1` = Hide Sensitive, `2` = Hide All. Default: `0`. - **set_roaming_always_on** (`boolean`): Whether data roaming is forced to always on. Default: `false`. - **allow_data_saver** (`boolean`): Whether Data Saver mode is allowed. Default: `false`. - **allow_data_saver_restriction** (`boolean`): Whether Data Saver restriction is enabled. Default: `false`. - **allow_cert_based_authentication_for_managed_apps** (`boolean`): Whether certificate-based authentication is allowed for managed apps. Default: `true`. - **allow_install_or_modify_certificates** (`boolean`): Whether the user can install or modify certificates. Default: `true`. - **allow_secured_wifi** (`integer`): Whether secured Wi-Fi is allowed. `0` = Restricted, `1` = Allowed. Default: `1`. - **allow_auto_fill_service** (`boolean`): Whether the autofill service is allowed. Default: `false`. - **allow_all_apps_access** (`integer`): Whether all apps are accessible in Managed Google Play. `0` = Restricted, `1` = Allowed. Default: `0`. - **allow_usb_file_transfer** (`boolean`): Whether USB file transfer is allowed. Default: `true`. - **allow_personal_space_screen_capture** (`boolean`): Whether screen capture is allowed in the personal space. Default: `true`. - **allow_personal_space_camera** (`boolean`): Whether the camera is allowed in the personal space. Default: `true`. - **app_filter_type** (`integer`): App filtering mode. `-1` = Not Configured. Default: `-1`. - **apps_list** (`JSON array`): List of apps for the app filter. ## Possible Response Codes - **200**: HTTP code. ## Sample Response: HTTP 200 Full configuration details of Restrictions payload item ```json { "payload_id": 9007199254741000, "allow_disabling_cellular_data": 1, "allow_non_market_app_instal": 1, "allow_data_while_roaming": 1, "allow_camera": 1, "allow_bluetooth": 4, "external_storage_encryption": 2, "allow_storage_encryption": 2, "allow_app_auto_sync": 1, "allow_background_data": 1, "allow_usb": 1 } ``` ## Rate Limit **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.