> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hoplynk.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Link

> Return a single WAN link by name or type, including real-time metrics and data usage.

<ParamField path="kit_id" type="string" required>
  UUID of the kit.
</ParamField>

<ParamField path="link_name" type="string" required>
  Link identifier (case-insensitive). Accepts:

  * Classified type: `starlink`, `cellular`, `ethernet`, `wifi`
  * Interface name: `eth3`, `eth4`
</ParamField>

## Response

Returns a single link object with the same fields as [List Links](/api-reference/kits/links), including the `usage` block.

## Example

<CodeGroup>
  ```python Python theme={null}
  starlink = client.get_link(kit_id, "starlink")
  cellular = client.get_link(kit_id, "cellular")

  print(f"Starlink: {starlink['status']}  {starlink['latency_ms']}ms")
  print(f"Month: {starlink['usage']['month_rx_gb']} GB down / {starlink['usage']['month_tx_gb']} GB up")
  ```

  ```javascript JavaScript theme={null}
  const starlink = await client.getLink(kitId, 'starlink')
  console.log(starlink.status, `${starlink.latency_ms}ms`)
  ```

  ```bash cURL theme={null}
  curl https://argus.hoplynk.com/api/kits/$KIT_ID/links/starlink \
    -H "X-API-Key: hlk_..."

  # Or by interface name:
  curl https://argus.hoplynk.com/api/kits/$KIT_ID/links/eth3 \
    -H "X-API-Key: hlk_..."
  ```
</CodeGroup>

```json Response theme={null}
{
  "name": "eth3",
  "type": "starlink",
  "status": "online",
  "isp": "SpaceX Services",
  "ip": "98.97.77.68",
  "rx_bps": 28400000,
  "tx_bps": 6200000,
  "latency_ms": 28,
  "jitter_ms": 1.4,
  "packet_loss_pct": 0.0,
  "availability_pct": 99.8,
  "usage": {
    "today_rx_gb": 4.2,
    "today_tx_gb": 1.1,
    "month_rx_gb": 87.3,
    "month_tx_gb": 22.6
  }
}
```