# Retrieve the full configuration details of a Restrictions payload item

To get Mac Restrictions policy payload item

## Endpoints

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

## Request URL

```
https://{serverurl}/api/v1/mdm/profiles/{profile_id}/payloads/macrestrictionspolicy/payloaditems/{payload_id}
```

## Scope

```
MDMOnDemand.MDMDeviceMgmt.READ
```

## Header

```
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
```

## Request Parameters

### 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/ios_getrestrictionspayloadios.html) response

### Query Parameters

- **t** (long) — Optional
- **ignoreHeader** (boolean) — Optional
- **qlt** (long) — Optional
- **previousTab** (string) — Optional
- **service** (string) — Optional
- **search** (string) — Optional  
  Free-text search string applied to the default searchable fields of the resource
- **all** (boolean) — Optional
- **dc_customerid** (long) — Optional
- **mdm_instance** (string) — Optional
- **signupsrc** (string) — Optional
- **zaaid** (string) — Optional
- **command** (string) — Optional
- **orderby** (string) — Optional
- **sortorder** (string) — Optional
- **select_all** (boolean) — Optional  
  When true, applies the operation to every record matching the current filter rather than to specific IDs. Default: false
- **zoho-internal** (boolean) — Optional
- **dc_instance** (string) — Optional
- **SUBREQUEST** (string) — Optional
- **source** (string) — Optional
- **nocache** (long) — Optional  
  param to avoid being served from cache
- **wms_csrparam** (string) — Optional  
  CSRF Token

## Sample Request

### Curl

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

### Java

```java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.io.IOException;
import java.net.http.HttpTimeoutException;

public class Main {
  public static void main(String[] args) {

    HttpRequest request = HttpRequest.newBuilder()
        .uri(URI.create("https://appdomain/api/v1/mdm/profiles/{profile_id}/payloads/macrestrictionspolicy/payloaditems/{payload_id}"))
        .header("Authorization", "Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52")
        .method("GET", HttpRequest.BodyPublishers.noBody())
        .build();
    HttpResponse<String> response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
    System.out.println(response.body());

  }
}
```

### Python

```python
import http.client

conn = http.client.HTTPSConnection("appdomain")

headers = { 'Authorization': "Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52" }

conn.request("GET", "/api/v1/mdm/profiles/{profile_id}/payloads/macrestrictionspolicy/payloaditems/{payload_id}", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))
```

### Deluge

```javascript
headersMap = Map();
headersMap.put("Accept", "application/json");

response = invokeUrl
[
    url: "https://appDomain/api/v1/mdm/profiles/{profile_id}/payloads/macrestrictionspolicy/payloaditems/{payload_id}"
    type: GET
    headers: headersMap
    connection: connection_name
]

info response;
```

### PowerShell

```powershell
$headers=@{}
$headers.Add("Authorization", "Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52")
$response = Invoke-WebRequest -Uri 'https://appdomain/api/v1/mdm/profiles/{profile_id}/payloads/macrestrictionspolicy/payloaditems/{payload_id}' -Method GET -Headers $headers
```

## Response Parameters

### HTTP 200

**Response Body** — `application/json`

- **payload_id** (long)  
  Unique identifier of the payload item
- **allow_game_center** (boolean)  
  Allow Game Center. Default: true
- **allow_modifi_wallpaper** (boolean)  
  Allow Modifi Wallpaper. Default: true
- **allow_use_of_camera** (boolean)  
  Allow Use Of Camera. Default: true
- **allow_cloud_document_sync** (boolean)  
  Allow Cloud Document Sync. Default: true
- **allow_cloud_keychain_sync** (boolean)  
  Allow Cloud Keychain Sync. Default: true
- **allow_touch_id** (boolean)  
  Allow Touch Id. Default: true
- **safari_allow_autofill** (boolean)  
  Safari Allow Autofill. Default: true
- **allow_spotlight_result** (boolean)  
  Allow Spotlight Result. Default: true
- **force_assist_profanity_filter** (boolean)  
  Force Assist Profanity Filter. Default: false
- **allow_activity_continuation** (boolean)  
  Allow Activity Continuation. Default: true
- **allow_dictionary_lookup** (boolean)  
  Allow Dictionary Lookup. Default: true
- **allow_music_service** (boolean)  
  Allow Music Service. Default: true
- **allow_screen_capture** (boolean)  
  Allow Screen Capture. 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
- **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_cloud_photo_lib** (boolean)  
  Allow Cloud Photo Lib. Default: true
- **request_to_leave_classroom** (boolean)  
  Request To Leave Classroom. Default: false
- **allow_content_caching** (boolean)  
  Allow Content Caching. Default: true
- **allow_itunes_file_sharing** (boolean)  
  Allow Itunes File Sharing. Default: true
- **allow_auto_unlock** (boolean)  
  Allow Auto Unlock. Default: true
- **allow_cloud_desktop_document** (boolean)  
  Allow Cloud Desktop Document. Default: true
- **allow_cloud_bookmarks** (boolean)  
  Allow Cloud Bookmarks. Default: true
- **allow_cloud_mail** (boolean)  
  Allow Cloud Mail. Default: true
- **allow_cloud_calender** (boolean)  
  Allow Cloud Calender. Default: true
- **allow_cloud_reminders** (boolean)  
  Allow Cloud Reminders. Default: true
- **allow_cloud_addressbook** (boolean)  
  Allow Cloud Addressbook. Default: true
- **allow_cloud_notes** (boolean)  
  Allow Cloud Notes. Default: true
- **gatekeeper_setting** (integer)  
  Gatekeeper app source restriction. Allowed values: 1=App Store Only, 2=App Store and Identified Developers, 3=Anywhere, 4=Not Configured. Default: 4
- **allow_override_gatekeeper** (boolean)  
  Allow Override Gatekeeper. Default: false
- **allow_dictation** (boolean)  
  Allow Dictation. Default: true
- **allow_assistant** (boolean)  
  Allow Assistant. Default: true
- **allow_use_of_ibookstore** (boolean)  
  Allow Use Of Ibookstore. Default: true
- **allow_ibookstore_erotica_media** (boolean)  
  Allow Ibookstore Erotica Media. Default: true
- **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_find_my_friend** (boolean)  
  Allow Find My Friend. Default: true
- **allow_find_my_device** (boolean)  
  Allow Find My Device. Default: true
- **allow_erase_content_settings** (boolean)  
  Allow Erase Content Settings. Default: true
- **is_rating_enabled** (boolean)  
  Is Rating Enabled. Default: false
- **country_code** (string)  
  Country Code. Default: us
- **allow_cloud_private_relay** (boolean)  
  Allow Cloud Private Relay. Default: true
- **allow_usb_restriction_mode** (boolean)  
  Allow Usb Restriction Mode. Default: true
- **allow_universal_control** (boolean)  
  Allow Universal Control. Default: true
- **allow_profile_installation** (boolean)  
  Allow Profile Installation. 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_airdrop** (boolean)  
  Allow Airdrop. Default: true
- **allow_bluetooth_modification** (boolean)  
  Allow Bluetooth Modification. Default: true
- **bluetooth_setting** (integer)  
  Bluetooth Setting. Allowed values: 0=Off, 1=On, 2=Not Configured. Default: 2
- **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_modifi_passcode** (boolean)  
  Allow Modifi Passcode. Default: true
- **allow_diagnostic_submission** (boolean)  
  Allow Diagnostic Submission. Default: True
- **allow_apple_personalized_ads** (boolean)  
  Allow Apple Personalized Ads. Default: True
- **allow_iphone_mirroring** (boolean)  
  Allow Iphone Mirroring. Default: True
- **allow_modifi_device_name** (boolean)  
  Allow Modifi Device Name. Default: True
- **allow_cloud_freeform** (boolean)  
  Allow Cloud Freeform. Default: True
- **enforced_fingerprint_timeout** (long)  
  Enforced Fingerprint Timeout. Default: 172800
- **allow_modify_touch_id** (boolean)  
  Allow Modify Touch Id. Default: True
- **allow_printer_sharing_modification** (boolean)  
  Allow Printer Sharing Modification. Default: True
- **allow_file_sharing_modification** (boolean)  
  Allow File Sharing Modification. Default: True
- **allow_internet_sharing_modification** (boolean)  
  Allow Internet Sharing Modification. Default: True
- **allow_bluetooth_sharing_modification** (boolean)  
  Allow Bluetooth Sharing Modification. Default: True
- **allow_time_machine_backup** (boolean)  
  Allow Time Machine Backup. Default: True
- **allow_multiplayer_gaming** (boolean)  
  Allow Multiplayer Gaming. Default: True
- **allow_local_user_creation** (boolean)  
  Allow Local User Creation. Default: True
- **airplay_incoming_request** (boolean)  
  Airplay Incoming Request. Default: True
- **allow_account_modification** (boolean)  
  Allow Account Modification. Default: True
- **allow_ard_remote_management_modification** (boolean)  
  Allow Ard Remote Management Modification. Default: True
- **allow_startup_disk_modification** (boolean)  
  Allow Startup Disk Modification. Default: True
- **allow_remote_apple_events_modification** (boolean)  
  Allow Remote Apple Events Modification. Default: True
- **allow_image_playground** (boolean)  
  Allow Image Playground. 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
- **force_delayed_app_software_updates** (boolean)  
  Force Delayed App Software Updates. Default: False
- **force_delayed_major_software_updates** (boolean)  
  Force Delayed Major Software Updates. Default: False
- **software_update_delay** (long)  
  Software Update Delay. Default: 30
- **software_update_minor_os_deferred_install_delay** (long)  
  Software Update Minor Os Deferred Install Delay. Default: 30
- **software_update_major_os_deferred_install_delay** (long)  
  Software Update Major Os Deferred Install Delay. Default: 30
- **software_update_non_os_deferred_install_delay** (long)  
  Software Update Non Os Deferred Install 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
- **force_bypass_screen_capture_alert** (boolean)  
  Force Bypass Screen Capture Alert. Default: False
- **allow_media_sharing_modification** (boolean)  
  Allow Media Sharing Modification. Default: False
- **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_safari_private_browsing** (boolean)  
  Allow Safari Private Browsing. Default: True
- **allow_safari_history_clearing** (boolean)  
  Allow Safari History Clearing. Default: True

## Sample Response — HTTP 200

Full configuration details of Restrictions payload item

```json
{
  "allow_activity_continuation": true,
  "payload_id": 9007199254741000,
  "safari_allow_autofill": true,
  "force_assist_profanity_filter": false,
  "allow_cloud_document_sync": true,
  "allow_game_center": true,
  "allow_use_of_camera": true,
  "allow_touch_id": true,
  "allow_modifi_wallpaper": true,
  "allow_spotlight_result": true,
  "allow_cloud_keychain_sync": true
}
```

## API Rate Limits

**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.