---
title: "List Harbor Connections"
method: GET
path: "/api/harbor/connections"
tags: ["Harbor Discovery"]
---

# List Harbor Connections

`GET /api/harbor/connections`

## Request

- Base URL: `https://app.polytomic.com`
- URL: `https://app.polytomic.com/api/harbor/connections`
- Auth: one of:
  - HTTP bearer
  - HTTP basic

Lists profile-authorized connections and capabilities for the current Harbor credential.

## Query parameters

- `limit` integer: Maximum number of results to return
- `page_token` string: Token from the previous page

## Headers

- `X-Polytomic-Version` string
- `X-Polytomic-Harbor-Session` string: Harbor session token; when supplied, the session must be active and bound to this credential and Harbor.
- `X-Polytomic-Activity-Request-ID` string: New nonzero UUID for each request, required for scoped credentials; a reused value is rejected.

## Response `200`

OK

- HarborConnectionListEnvelope
  - `data` HarborConnectionResponse[], nullable: Connections on this page
    - `capabilities` HarborConnectionCapability[], nullable: Operations the credential can perform on the connection: schemas, query, or record_view_links
    - `id` string, uuid: Connection ID
    - `name` string: Connection name
    - `type` string: Connection type
  - `pagination` PaginationDetails
    - `next_page_token` string: Token for fetching the next page of results

## Changes

- **2026-10-26** `82ef9c39493c`: 3 warning
  - added the new `query` enum value to the `data/items/capabilities/items/` response property for the response status `200`
  - added the new `record_view_links` enum value to the `data/items/capabilities/items/` response property for the response status `200`
  - added the new `schemas` enum value to the `data/items/capabilities/items/` response property for the response status `200`
- **2026-10-22** `d80b0fdea14e`: 1 breaking, 1 warning, 1 info
  - the `pagination` response's property type changed from `object` to no type for status `200`
  - removed the optional property `pagination/next_page_token` from the response with the `200` status
  - added `#/components/schemas/PaginationDetails` to the `pagination` response property `allOf` list for the response status `200`
- **2026-09-05** `30ade6c6d535`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/polytomic/apis/polytomic-api/changes/api/harbor/connections/get.md)

---

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