GET private-location/{geoloc}/private-agents
Lists all private agents for a specified private location.
URL Parameters
Name | Description |
---|---|
geoloc | The geolocation string. |
Remarks
Use GET private locations route to get the list of private locations having values applicable for geoloc.Request example
curl --request GET "https://api-asm1.apica.io/v3/private-location/{geoloc}/private-agents?auth_ticket=C471ADC4-19B4-4219-BBF4-671A97EC653E"
Response body model example and description
[ { "agent_id": "bbeb4e22-d3ba-41a6-880d-f3a935bd8ac2", "agent_name": "sample string 2", "customer_guid": "8b1d6b7c-0d51-4409-89a9-5a30ab42d9e6", "geoloc": "sample string 4", "created_utc": "2025-09-17T03:40:04", "last_updated_utc": "2025-09-17T03:40:04", "enabled": true, "health": "sample string 8", "status": "sample string 9", "status_updated_at": 10, "certificate_valid_from_utc": "2025-09-17T03:40:04", "certificate_valid_till_utc": "2025-09-17T03:40:04", "node_status": "sample string 13", "status_description": "sample string 14", "scheduling_eligibility": "sample string 15" }, { "agent_id": "6e3bff97-fcc7-4835-8984-0805d1738680", "agent_name": "sample string 2", "customer_guid": "ce9c4ec9-149e-49ff-a4d7-dfbaede3d760", "geoloc": "sample string 4", "created_utc": "2025-09-17T03:40:04", "last_updated_utc": "2025-09-17T03:40:04", "enabled": true, "health": "sample string 8", "status": "sample string 9", "status_updated_at": 10, "certificate_valid_from_utc": "2025-09-17T03:40:04", "certificate_valid_till_utc": "2025-09-17T03:40:04", "node_status": "sample string 13", "status_description": "sample string 14", "scheduling_eligibility": "sample string 15" }, { "agent_id": "fd70e0df-dda6-4122-b1c1-68a16ba39f56", "agent_name": "sample string 2", "customer_guid": "53d3641a-db94-46b3-a7c3-b755dc295121", "geoloc": "sample string 4", "created_utc": "2025-09-17T03:40:04", "last_updated_utc": "2025-09-17T03:40:04", "enabled": true, "health": "sample string 8", "status": "sample string 9", "status_updated_at": 10, "certificate_valid_from_utc": "2025-09-17T03:40:04", "certificate_valid_till_utc": "2025-09-17T03:40:04", "node_status": "sample string 13", "status_description": "sample string 14", "scheduling_eligibility": "sample string 15" } ]
Name | Type | Description |
---|---|---|
AgentId | Guid |
The unique identifier of the agent. |
AgentName | String |
The name of the agent. |
CustomerGuid | Guid |
The unique identifier of the customer. |
Geoloc | String |
The geolocation string. |
CreatedUtc | DateTime |
The UTC timestamp when the agent was created. |
LastUpdatedUtc | DateTime |
The UTC timestamp when the agent was last updated. |
Enabled | Boolean |
Indicates whether the agent is enabled. |
Health | String |
The health status of the agent. |
Status | String |
The current status of the agent. |
StatusUpdatedAt | Integer |
The timestamp when the status was last updated. |
CertificateValidFromUtc | DateTime |
The UTC timestamp from when the agent's certificate is valid. |
CertificateValidTillUtc | DateTime |
The UTC timestamp until the agent's certificate is valid. |
NodeStatus | String |
The status of the node. |
StatusDescription | String |
A description of the agent's status. |
SchedulingEligibility | String |
Indicates the scheduling eligibility of the agent. |