# Retrieve the full configuration details of a Wi-Fi payload item

To Get Mac Wifi policy payload item

## Endpoints

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

## Request URL

`https://{server-hostname}:8383/api/v1/mdm/profiles/{profile_id}/payloads/macwifipolicy/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/mac-get-wi-fi-payload-mac.html) response.

## Sample Request

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

## Response Parameters

### HTTP code 200

#### Response Body — application/json

`JSON Object`

- **payload_id** `long`
  - Unique identifier of the payload item
- **sub_config** `string`
  - WiFi configuration sub-type indicating the authentication mode. Values: WIFI_NON_ENTERPRISE (personal/PSK networks) or WIFI_ENTERPRISE (802.1X networks). Default: WIFI_NON_ENTERPRISE
- **service_set_identifier** `string`
  - The network name (SSID) of the WiFi network to connect to
- **auto_join** `boolean`
  - Whether the device automatically joins this WiFi network when in range. Default: true
- **hidden_network** `boolean`
  - Whether the WiFi network is hidden (does not broadcast its SSID). When true, the device will probe for the network. Default: false
- **security_type** `string`
  - WiFi security type. Allowed values: 0=None (Open), 1=WEP (Personal), 2=WPA/WPA2 (Personal), 3=Any (Personal), 4=WEP (Enterprise), 5=WPA/WPA2 (Enterprise), 6=Any (Enterprise), 7=WPA3 (Personal), 8=WPA3 (Enterprise)
- **wifi_non_enterprise** `JSON Object`
  - Configuration object for personal/PSK WiFi networks containing the pre-shared key or WEP password
- **wifi_enterprise** `JSON Object`
  - Configuration object for 802.1X enterprise WiFi networks containing EAP settings, certificates, and authentication credentials
- **proxy_type** `string`
  - Proxy configuration type. Allowed values: 0=None, 1=Manual, 2=Automatic (PAC URL)
- **proxy_server** `string`
  - Hostname or IP address of the HTTP proxy server. Required when proxy_type is 1 (Manual)
- **proxy_server_port** `string`
  - Port number of the HTTP proxy server. Valid range: 0-65535. Default: 0
- **proxy_user_name** `string`
  - Username for proxy server authentication
- **proxy_password** `string`
  - Password for proxy server authentication (sensitive - write-only, not returned in responses)
- **proxy_password_id** `long`
  - Internal identifier for the stored proxy password credential
- **proxy_pac_url** `string`
  - URL of the Proxy Auto-Configuration (PAC) file. Required when proxy_type is 2 (Automatic)
- **setup_modes** `string`
  - WiFi setup mode. Allowed values: 1=System mode, 2=Login window mode, 3=Both system and login window
- **disable_mac_randomize** `boolean`
  - Whether to disable MAC address randomization for this network. When true, the device uses its real hardware MAC address. Default: false

## Possible Response Codes

**200** `HTTP code`

## Sample Response: HTTP 200

Full configuration details of Wi-Fi payload item

```json
{
  "payload_id": 9007199254741000,
  "wifi_non_enterprise": {},
  "sub_config": "WIFI_NON_ENTERPRISE",
  "wifi_enterprise": {},
  "proxy_server": "value",
  "auto_join": true,
  "hidden_network": false,
  "proxy_server_port": 0,
  "service_set_identifier": "value",
  "security_type": 3,
  "proxy_type": 0
}
```

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