Skip to main content
ldsouza
Staff
Staff
July 28, 2025

Technical Tip: View HA cluster members and their roles via REST API

  • July 28, 2025
  • 0 replies
  • 260 views
Description This article describes how to use Postman/curl to view HA cluster members and their roles via REST API.
Scope FortiWeb, FortiWeb VM.
Solution

To view HA cluster members and their roles, use the following API endpoint:

 

curl -i -k -H "Authorization: <TOKEN>" -H "Content-Type: application/json" -H "Accept: application/json" -XGET "https://<HOSTNAME>/api/v2.0/system/config.hatopology"

 

Example:

 

curl -vk \
-H "Authorization: eyJ1c2VybmFtZSI6ImFkbWluIiwicGFzc3dvcmQiOiJmb3J0aW5ldCIsInZkb20iOiJyb290In0K" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-X GET "https://xx.xx.xx.xx/api/v2.0/system/config.hatopology"


Example response:

 

{
"results": {
"data": [
{
"role": "PRIMARY",
"mode": "mode_ap",
"host_name": "FWEB1",
"device_number": "FVVM01TMXXXXX36",
"device_id": 1,
"is_current": true,
"ip": "169.254.0.1",
"priority": 5,
"uptime": { "days": 0, "hours": 0, "minutes": 25 },
"cpu_usage": 7,
"memory_usage": 21,
"logdisk_usage": 2,
"total_connect": 0,
"total_connect_sec": 0,
"throughput": "0.000 Kbps"
},
{
"role": "SECONDARY",
"mode": "mode_ap",
"host_name": "FWEB2",
"device_number": "FVVM01TMXXXXXX33",
"device_id": 2,
"is_current": false,
"ip": "169.254.0.2",
"priority": 6,
"uptime": { "days": 0, "hours": 0, "minutes": 23 },
"cpu_usage": 6,
"memory_usage": 21,
"logdisk_usage": 2,
"total_connect": 0,
"total_connect_sec": 0,
"throughput": "0.000 Kbps"
}
],
"multi_group": 0
}
}

 

Note: This API response will display only the active members in the cluster. Any disconnected members will not be visible in the response.

Thought Leadership Security Summit. Outpace New Threats with AI - enhanced defense. Tuesday, Septmeber 15, 8:30 AM - 2:30 PM PT. The Golf Club at Newcastle, WA.
Fortinet Flag the Hack. Wednesday, August 26, 9:00 AM - 5:00 PM ET, COSM, Atlanta, GA.
Virtual event | September 2026. SASE summit. The age of autonomous trust. Register here!