# Retrieve the full configuration details of a Restrictions payload item To get Restrictions policy payload item ## Endpoint `GET /api/v1/mdm/profiles/{profile_id}/payloads/restrictionspolicy/payloaditems/{payload_id}` ## Request URL `https://{server-hostname}:8383/api/v1/mdm/profiles/{profile_id}/payloads/restrictionspolicy/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-restrictions-payload2.html) response. ## Sample Request ```curl curl --request GET \ --url https://appdomain/api/v1/mdm/profiles/{profile_id}/payloads/restrictionspolicy/payloaditems/{payload_id} \ --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. - **allow_app_installation** (boolean): Allow App Installation. Default: true. - **allow_app_removal** (boolean): Allow App Removal. Default: true. - **allow_use_of_camera** (boolean): Allow Use Of Camera. Default: true. - **allow_face_time** (boolean): Allow Face Time. Default: true. - **allow_airdrop** (boolean): Allow Airdrop. Default: true. - **allow_imessage** (boolean): Allow Imessage. Default: true. - **allow_modifi_passcode** (boolean): Allow Modifi Passcode. Default: true. - **allow_screen_capture** (boolean): Allow Screen Capture. Default: true. - **allow_sync_while_roaming** (boolean): Allow Sync While Roaming. Default: true. - **allow_assistant** (boolean): Allow Assistant. Default: true. - **allow_assistant_when_locked** (boolean): Allow Assistant When Locked. Default: true. - **force_assist_profanity_filter** (boolean): Force Assist Profanity Filter. Default: false. - **allow_assistant_user_content** (boolean): Allow Assistant User Content. Default: true. - **allow_touch_id** (boolean): Allow Touch Id. Default: true. - **allow_passbook_when_locked** (boolean): Allow Passbook When Locked. Default: true. - **show_control_center** (boolean): Show Control Center. Default: true. - **show_notification_center** (boolean): Show Notification Center. Default: true. - **show_today_view** (boolean): Show Today View. Default: true. - **allow_voice_dialing** (boolean): Allow Voice Dialing. Default: true. - **allow_inapp_purchase** (boolean): Allow Inapp Purchase. Default: true. - **force_istore_pwd_entry** (boolean): Force Istore Pwd Entry. Default: false. - **allow_game_center** (boolean): Allow Game Center. Default: true. - **allow_multiplayer_gaming** (boolean): Allow Multiplayer Gaming. Default: true. - **allow_add_game_center_friend** (boolean): Allow Add Game Center Friend. Default: true. - **allow_use_of_youtube** (boolean): Allow Use Of Youtube. Default: true. - **allow_use_of_ibookstore** (boolean): Allow Use Of Ibookstore. Default: true. - **allow_ibookstore_erotica_media** (boolean): Allow Ibookstore Erotica Media. Default: true. - **allow_itunes** (boolean): Allow Itunes. Default: true. - **allow_safari** (boolean): Allow Safari. Default: true. - **safari_allow_autofill** (boolean): Safari Allow Autofill. Default: true. - **safari_force_fraud_warning** (boolean): Safari Force Fraud Warning. Default: false. - **safari_allow_javascript** (boolean): Safari Allow Javascript. Default: true. - **safari_allow_popups** (boolean): Safari Allow Popups. Default: true. - **safari_accept_cookies** (integer): Safari cookie acceptance policy. Allowed values: 0=Never, 1=From current website only, 2=Always. Default: 2. - **allow_cloud_backup** (boolean): Allow Cloud Backup. Default: true. - **allow_cloud_document_sync** (boolean): Allow Cloud Document Sync. Default: true. - **allow_photo_stream** (boolean): Allow Photo Stream. Default: true. - **allow_shared_stream** (boolean): Allow Shared Stream. Default: true. - **allow_diagnostic_submission** (boolean): Allow Diagnostic Submission. Default: true. - **allow_untrusted_tls_prompt** (boolean): Allow Untrusted Tls Prompt. Default: true. - **allow_ota_pki_updates** (boolean): Allow Ota Pki Updates. Default: true. - **force_encrypted_backup** (boolean): Force Encrypted Backup. Default: false. - **force_limited_ad_tracking** (boolean): Force Limited Ad Tracking. Default: false. - **allow_profile_installation** (boolean): Allow Profile Installation. Default: true. - **allow_account_modification** (boolean): Allow Account Modification. Default: true. - **allow_find_my_friends_mod** (boolean): Allow Find My Friends Mod. Default: true. - **allow_host_pairing** (boolean): Allow Host Pairing. Default: true. - **allow_app_cellular_data** (boolean): Allow App Cellular Data. Default: true. - **allow_open_doc_in_unmanaged** (boolean): Allow Open Doc In Unmanaged. Default: true. - **allow_open_doc_in_managed** (boolean): Allow Open Doc In Managed. Default: true. - **allow_explicit_content** (boolean): Allow Explicit Content. Default: true. - **is_rating_enabled** (boolean): Is Rating Enabled. Default: false. - **country_code** (string): Country Code. Default: us. - **movies_rating_value** (integer): Movie content rating filter. Allowed values vary by country. US values: 0=Don't Allow, 100=G, 200=PG, 300=PG-13, 400=R, 500=NC-17, 1000=Allow All Movies. Default: 1000. - **tv_shows_rating_value** (integer): TV show content rating filter. Allowed values vary by country. US values: 0=Don't Allow, 100=TV-Y, 200=TV-Y7, 300=TV-G, 400=TV-PG, 500=TV-14, 600=TV-MA, 1000=Allow All TV Shows. Default: 1000. - **apps_rating_value** (integer): App Store content rating filter. Allowed values vary by country. US values: 0=Don't Allow, 100=4+, 200=9+, 300=12+, 600=17+, 1000=Allow All Apps. Default: 1000. - **allow_managed_app_cloud_sync** (boolean): Allow Managed App Cloud Sync. Default: true. - **allow_managed_book_backup** (boolean): Allow Managed Book Backup. Default: true. - **allow_managed_book_sync** (boolean): Allow Managed Book Sync. Default: true. - **allow_activity_continuation** (boolean): Allow Activity Continuation. Default: true. - **allow_erase_content_settings** (boolean): Allow Erase Content Settings. Default: true. - **allow_enabling_restriction** (boolean): Allow Enabling Restriction. Default: true. - **allow_spotlight_result** (boolean): Allow Spotlight Result. Default: true. - **allow_cloud_keychain_sync** (boolean): Allow Cloud Keychain Sync. Default: true. - **force_airplay_outgoing_pwd** (boolean): Force Airplay Outgoing Pwd. Default: false. - **allow_podcasts** (boolean): Allow Podcasts. Default: true. - **allow_dictionary_lookup** (boolean): Allow Dictionary Lookup. Default: true. - **allow_predictive_keyboard** (boolean): Allow Predictive Keyboard. Default: true. - **allow_auto_correction** (boolean): Allow Auto Correction. Default: true. - **allow_spellcheck** (boolean): Allow Spellcheck. Default: true. - **force_airplay_incoming_pwd** (boolean): Force Airplay Incoming Pwd. Default: false. - **force_watch_wrist_detect** (boolean): Force Watch Wrist Detect. Default: false. - **allow_modify_touch_id** (boolean): Allow Modify Touch Id. Default: true. - **force_airdrop_unmanaged** (boolean): Force Airdrop Unmanaged. Default: false. - **allow_keyboard_shortcut** (boolean): Allow Keyboard Shortcut. Default: true. - **allow_paired_watch** (boolean): Allow Paired Watch. Default: true. - **allow_modifi_device_name** (boolean): Allow Modifi Device Name. Default: true. - **allow_modifi_wallpaper** (boolean): Allow Modifi Wallpaper. - **allow_auto_app_download** (boolean): Allow Auto App Download. Default: true. - **allow_managed_app_trust** (boolean): Allow Managed App Trust. Default: true. - **allow_cloud_photo_lib** (boolean): Allow Cloud Photo Lib. Default: true. - **allow_music_service** (boolean): Allow Music Service. Default: true. - **allow_radio_service** (boolean): Allow Radio Service. Default: true. - **allow_diag_sub_modification** (boolean): Allow Diag Sub Modification. Default: true. - **allow_bluetooth_modification** (boolean): Allow Bluetooth Modification. Default: true. - **allow_dictation** (boolean): Allow Dictation. Default: true. - **force_wifi_whitelisting** (boolean): Force Wifi Whitelisting. Default: false. - **allow_news** (boolean): Allow News. Default: true. - **allow_airprint** (boolean): Allow Airprint. Default: true. - **allow_airprint_credential_storage** (boolean): Allow Airprint Credential Storage. Default: true. - **force_airprint_tls** (boolean): Force Airprint Tls. Default: false. - **allow_airprint_ibeacon_discovery** (boolean): Allow Airprint Ibeacon Discovery. Default: true. - **allow_vpn_creation** (boolean): Allow Vpn Creation. Default: true. - **allow_classroom_remoteview** (boolean): Allow Classroom Remoteview. Default: true. - **force_classroom_auto_join** (boolean): Force Classroom Auto Join. Default: false. - **force_classroom_appdevicelock** (boolean): Force Classroom Appdevicelock. Default: false. - **force_classroom_remoteview** (boolean): Force Classroom Remoteview. Default: false. - **request_to_leave_classroom** (boolean): Request To Leave Classroom. Default: false. - **allow_proximity_for_newdevice** (boolean): Allow Proximity For Newdevice. Default: true. - **authenticate_before_autofill** (boolean): Authenticate Before Autofill. Default: false. - **force_date_time** (boolean): Force Date Time. Default: false. - **time_zone** (string): Time Zone. Default: --. - **allow_password_autofill** (boolean): Allow Password Autofill. Default: true. - **allow_password_proximity** (boolean): Allow Password Proximity. Default: true. - **allow_password_sharing** (boolean): Allow Password Sharing. Default: true. - **allow_managed_write_unmanaged_contact** (boolean): Allow Managed Write Unmanaged Contact. Default: false. - **allow_unmanaged_read_managed_contact** (boolean): Allow Unmanaged Read Managed Contact. Default: false. - **allow_usb_restriction_mode** (boolean): Allow Usb Restriction Mode. Default: true. - **bluetooth_setting** (integer): Bluetooth setting. Allowed values: 0=Off, 1=On, 2=Not Configured. Default: 2. - **hotspot_setting** (integer): Personal hotspot setting. Allowed values: 0=Off, 1=On, 2=Not Configured. Default: 2. - **allow_hotspot_modification** (boolean): Allow Hotspot Modification. Default: true. - **allow_esim_modification** (boolean): Allow Esim Modification. Default: true. - **allow_siri_logging** (boolean): Allow Siri Logging. Default: true. - **allow_continuous_path_keyboard** (boolean): Allow Continuous Path Keyboard. Default: true. - **allow_find_my_friend** (boolean): Allow Find My Friend. Default: true. - **allow_find_my_device** (boolean): Allow Find My Device. Default: true. - **force_wifi_on** (boolean): Force Wifi On. Default: false. - **allow_usb_file_drive** (boolean): Allow Usb File Drive. Default: true. - **allow_system_app_removal** (boolean): Allow System App Removal. Default: true. - **allow_notification_modification** (boolean): Allow Notification Modification. Default: true. - **allow_app_clips** (boolean): Allow App Clips. Default: true. - **allow_apple_personalized_ads** (boolean): Allow Apple Personalized Ads. Default: true. - **allow_cellular_plan_modification** (boolean): Allow Cellular Plan Modification. Default: true. - **allow_file_network_drive_access** (boolean): Allow File Network Drive Access. Default: true. - **allow_shared_device_guest_account** (boolean): Allow Shared Device Guest Account. Default: true. - **allow_nfc** (boolean): Allow Nfc. Default: true. - **allow_unpaired_external_boot_to_recovery** (boolean): Allow Unpaired External Boot To Recovery. Default: false. - **force_on_device_only_dictation** (boolean): Force On Device Only Dictation. Default: false. - **force_on_device_only_translation** (boolean): Force On Device Only Translation. Default: false. - **require_managed_pasteboard** (boolean): Require Managed Pasteboard. Default: false. - **allow_auto_unlock** (boolean): Allow Auto Unlock. Default: true. - **allow_cloud_private_relay** (boolean): Allow Cloud Private Relay. Default: true. - **allow_mail_privacy_protection** (boolean): Allow Mail Privacy Protection. Default: true. - **allow_rapid_security_response_installation** (boolean): Allow Rapid Security Response Installation. Default: true. - **allow_rapid_security_response_removal** (boolean): Allow Rapid Security Response Removal. Default: true. - **allow_live_voicemail** (boolean): Allow Live Voicemail. Default: true. - **allow_iphone_widgets_on_mac** (boolean): Allow Iphone Widgets On Mac. Default: true. - **allow_marketplace_app_installation** (boolean): Allow Marketplace App Installation. Default: true. - **allow_web_distribution_app_installation** (boolean): Allow Web Distribution App Installation. Default: true. - **allow_genmoji** (boolean): Allow Genmoji. Default: True. - **allow_image_playground** (boolean): Allow Image Playground. Default: True. - **allow_image_wand** (boolean): Allow Image Wand. Default: True. - **allow_iphone_mirroring** (boolean): Allow Iphone Mirroring. Default: True. - **allow_personalized_handwriting_results** (boolean): Allow Personalized Handwriting Results. Default: True. - **allow_writing_tools** (boolean): Allow Writing Tools. Default: True. - **allow_external_intelligence_integrations** (boolean): Allow External Intelligence Integrations. Default: True. - **force_delayed_software_updates** (boolean): Force Delayed Software Updates. Default: False. - **software_update_delay** (long): Software Update Delay. Default: 30. - **allow_external_intelligence_integrations_signin** (boolean): Allow External Intelligence Integrations Signin. Default: True. - **allow_mail_summary** (boolean): Allow Mail Summary. Default: True. - **allow_notes_transcription_summary** (boolean): Allow Notes Transcription Summary. Default: True. - **allow_external_intelligence_workspace_ids** (string): Allow External Intelligence Workspace Ids. - **allow_default_browser_modification** (boolean): Allow Default Browser Modification. Default: True. - **allow_safari_private_browsing** (boolean): Allow Safari Private Browsing. Default: True. - **allow_safari_history_clearing** (boolean): Allow Safari History Clearing. Default: True. - **allowed_camera_restriction_app_id** (array): List of app IDs (long) allowed to use the camera when camera is restricted. Use the `app_group_id` from the [Apps API](https://www.manageengine.com/products/desktop-central/help/api/onpremise/app-management-get-an-app.html) response. - **default_browser_app_details** (JSON Object): Default Browser App Details. - **default_calling_app_details** (JSON Object): Default Calling App Details. - **default_messaging_app_details** (JSON Object): Default Messaging App Details. - **allow_rcs_messaging** (boolean): Allow Rcs Messaging. Default: True. - **allow_call_recording** (boolean): Allow Call Recording. Default: True. - **allow_apps_to_be_locked** (boolean): Allow Apps To Be Locked. Default: True. - **allow_apps_to_be_hidden** (boolean): Allow Apps To Be Hidden. Default: True. - **allow_visual_intelligence_summarization** (boolean): Allow Visual Intelligence Summarization. Default: True. - **allow_apple_intelligence_report** (boolean): Allow Apple Intelligence Report. Default: True. - **allow_mail_smart_replies** (boolean): Allow Mail Smart Replies. Default: True. - **allow_safari_summary** (boolean): Allow Safari Summary. Default: True. - **allow_default_calling_app_modification** (boolean): Allow Default Calling App Modification. Default: True. - **allow_default_messaging_app_modification** (boolean): Allow Default Messaging App Modification. Default: True. ## Possible Response Codes - **200**: HTTP code. ## Sample Response: HTTP 200 Full configuration details of Restrictions payload item ```json { "payload_id": 9007199254741000, "allow_app_installation": true, "allow_face_time": true, "allow_assistant": true, "allow_modifi_passcode": true, "allow_use_of_camera": true, "allow_app_removal": true, "allow_airdrop": true, "allow_screen_capture": true, "allow_imessage": true, "allow_sync_while_roaming": true } ``` ## API 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.