---
title: "Lists your connections."
method: GET
path: "/api/Connections"
tags: ["Connections"]
---

# Lists your connections.

`GET /api/Connections`

## Request

- Base URL: `https://api.3dprintlog.com`
- URL: `https://api.3dprintlog.com/api/Connections`
- Auth: one of:
  - OAuth 2 (authorization code, authorization URL `https://3dprintlog.auth0.com/authorize`, token URL `https://3dprintlog.auth0.com/oauth/token`)
  - API key in header `X-Api-Key`
  - API key in query parameter `api_key`

## Query parameters

- `printerId` integer

## Response `200`

Your connections, each with its status: stale after 15 minutes without a heartbeat.

- PrintLogApiModelsDTOsConnectionConnectionDto[]
  - `id` string, uuid
  - `kind` string, nullable: The connector type, lower-case: `moonraker`, `octoprint`.
  - `instanceId` string, nullable: The agent's own stable id for this printer.
  - `displayName` string, nullable
  - `agentVersion` string, nullable
  - `latestAgentVersion` string, nullable: The newest release of this connection's agent (printlog-bridge for `moonraker`), as `X.Y.Z`, or null when 3D Print Log doesn't know it. Read from the agent's GitHub tags every few hours, so agents learn of an update from their check-in and never call GitHub.
  - `updateAvailable` boolean: Whether PrintLogApi.Models.DTOs.Connection.ConnectionDto.AgentVersion is older than PrintLogApi.Models.DTOs.Connection.ConnectionDto.LatestAgentVersion.
  - `printerId` integer, nullable: The printer this connection logs prints for, or null when it is not bound to one.
  - `createdDate` string, date-time
  - `lastSeenAt` string, date-time: When the agent last sent a heartbeat.
  - `status` 1 | 2: Whether a connection's agent is still sending heartbeats. Sent as an integer: `1` = Online, `2` = Stale.
  - `droppedNotifierEventCount` integer: Moonraker notifier events dropped because this connection logs the same printer. Each job is logged once, by the connection.
  - `lastDroppedNotifierEventAt` string, date-time, nullable: When a notifier event was last dropped.
  - `notifierNoticeDismissedAt` string, date-time, nullable: When you dismissed the notice about the notifier.
  - `showNotifierNotice` boolean: Whether to suggest removing the `[notifier]` section from moonraker.conf: events were dropped and the notice has not been dismissed.
  - `mode` string, nullable: How the agent reaches the printer: `local` or `remote`.
  - `klipperVersion` string, nullable
  - `moonrakerVersion` string, nullable
  - `printerModel` string, nullable: The printer model the slicer wrote in the last job's file.
  - `outboxDepth` integer, nullable: Events and pictures waiting in the agent's outbox to be sent.
  - `outboxOldestQueuedAt` string, date-time, nullable: When the oldest of them was queued.
  - `lastError` string, nullable: The last warning or error the agent logged for this printer.
  - `lastErrorAt` string, date-time, nullable: When it was logged.
  - `errorCount` integer, nullable: Warnings and errors logged between the agent's last two heartbeats.
  - `snapshots` boolean, nullable: Whether a webcam frame is added to each print.
  - `slicerSettings` boolean, nullable: Whether each print's slicer settings are sent.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden

---

[API](https://skmtc.dev/3dprintlog/apis/3d-print-log-api.md) · [All operations](https://skmtc.dev/3dprintlog/apis/3d-print-log-api/llms.txt) · [OpenAPI document](https://skmtc.dev/3dprintlog/apis/3d-print-log-api/revisions/dfc3a4df4e38?raw)