---
title: "List P2P provider instances"
method: GET
path: "/p2p/preheat/instances"
tags: ["preheat"]
---

# List P2P provider instances

`GET /p2p/preheat/instances`

List P2P provider instances

## Query parameters

- `page` integer
- `page_size` integer
- `q` string
- `sort` string

## Headers

- `X-Request-Id` string

## Response `200`

Success

- Instance[]
  - `id` integer — Unique ID
  - `name` string — Instance name
  - `description` string — Description of instance
  - `vendor` string — Based on which driver, identified by ID
  - `endpoint` string — The service endpoint of this instance
  - `auth_mode` string — The authentication way supported
  - `auth_info` object — The auth credential data if it exists. When updating an instance (PUT `/p2p/preheat/instances/{preheat_instance_name}`), if this object is omitted or empty and `auth_mode` is not `NONE`, the previously stored credentials are kept.
  - `status` string — The health status
  - `enabled` boolean — Whether the instance is activated or not
  - `default` boolean — Whether the instance is default or not
  - `insecure` boolean — Whether the instance endpoint is insecure or not
  - `setup_timestamp` integer — The timestamp of instance setting up

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `500` — Internal server error

---

[API](https://skmtc.dev/goharbor/apis/harbor-api.md) · [All operations](https://skmtc.dev/goharbor/apis/harbor-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/goharbor/harbor-api/revisions/62d78801f8df/schema)