GET private-agent/get/{agent_id}
Retrieves a specific private agent by ID for the current customer.
URL Parameters
| Name | Description |
|---|---|
| agent_id | The ID of the agent to retrieve. |
Remarks
Use GET private agents route to get the list of private agents having values applicable for agent_id.Request example
curl --request GET "https://api-asm2.apica.io/v3/private-agent/get/{agent_id}?auth_ticket=C471ADC4-19B4-4219-BBF4-671A97EC653E"
Response body model example and description
{
"agent_id": "213b9837-c3df-4145-a6ae-cf50cc0d785c",
"agent_name": "sample string 2",
"customer_guid": "9cc6b881-afc8-4094-b4e2-d2c1aafe7392",
"geoloc": "sample string 4",
"created_utc": "2025-10-26T20:06:10",
"last_updated_utc": "2025-10-26T20:06:10",
"enabled": true,
"health": "sample string 8",
"status": "sample string 9",
"status_updated_at": 10,
"certificate_valid_from_utc": "2025-10-26T20:06:10",
"certificate_valid_till_utc": "2025-10-26T20:06:10",
"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. |