---
title: "Get Agent connections for run"
method: GET
path: "/runs/{id}/agents/{agent_id}/connections"
tags: ["Runs"]
---

# Get Agent connections for run

`GET /runs/{id}/agents/{agent_id}/connections`

## Request

- Base URL: `https://localhost:8446/api/v2`
- URL: `https://localhost:8446/api/v2/runs/{id}/agents/{agent_id}/connections`
- Auth: API key in header `Authorization`

Returns Agent's connections for particular job run.

## Path parameters

- `id` string, required
- `agent_id` string, required

## Response `200`

Successful response

- object
  - `status` string, required: Connection status. Possible values: connected not connected
  - `unknown` boolean, required: Unknown peer connection
  - `folderid` string, required: Transfer id
  - `agent_deviceid` string, required: Agent device id
  - `agent_id` number, required: Agent id
  - `agent_name` string, required: Agent name
  - `connections_count` number, required: Connections count
  - `best_connection` string: Best connection
  - `best_connection_protocol` string: Best connection protocol
  - `is_network_policy` boolean, required: Connection is configured by network policy

## Other responses

- `default`: Error response. Depending on the error, either a 4xx or 5xx response status is returned.

---

[API](https://skmtc.dev/resilio/apis/resilio-api.md) - [All operations](https://skmtc.dev/resilio/apis/resilio-api/llms.txt) - [OpenAPI document](https://skmtc.dev/resilio/apis/resilio-api/revisions/ca39130a395e?raw)
