---
title: "List published connectors, one page at a time, with public readiness per placement"
method: GET
path: "/v1/connectors"
tags: ["public"]
---

# List published connectors, one page at a time, with public readiness per placement

`GET /v1/connectors`

## Request

- Base URL: `https://api.runx.ai`
- URL: `https://api.runx.ai/v1/connectors`
- Auth: none declared

## Query parameters

- `q` string
- `category` string
- `placement` string
- `publisher` string
- `limit` string
- `cursor` string

## Response `200`

Connector catalog.

- PublicConnectorsResponse
  - `status` 'success', required
  - `query` PublicConnectorsQuery, required
    - `q` string
    - `category` string
    - `trust_tier` 'first_party' | 'verified' | 'community'
    - `placement` 'hosted' | 'local'
    - `publisher` string
  - `catalog_total` number, required
  - `total` number, required
  - `facets` object, required
    - `categories` object[], required
      - `count` number, required
      - `id` string, required
      - `label` string, required
    - `placements` object[], required
      - `placement` 'hosted' | 'local', required
      - `count` number, required
  - `connectors` PublicConnectorSummary[], required
    - `ref` string, required
    - `publisher` PublicPublisher, required
      - `id` string, required
      - `slug` string, required
      - `handle` string, required
      - `display_name` string, required
      - `kind` 'org' | 'user' | 'team', required
      - `verified` boolean, required
      - `image` PublicMark
        - `sha256` string, required
        - `url` string, required
      - `url` string, required
    - `id` string, required
    - `version` string, required
    - `name` string, required
    - `description` string, required
    - `category` PublicConnectorCategory, required
      - `id` string, required
      - `label` string, required
    - `runtime_capability` boolean, required
    - `trust_tier` 'first_party' | 'verified' | 'community', required
    - `auth_methods` PublicConnectorAuthMethod[], required
    - `placements` PublicConnectorPlacement[], required
      - `placement` 'hosted' | 'local', required
      - `auth` PublicConnectorAuthMethod[], required
      - `ready` boolean, required
      - `ready_operations` number, required
      - `reasons` PublicReadinessReason[], required
        - `check` 'requirement' | 'instance' | 'capability' | 'delegation' | 'approval' | 'implementation' | 'tolerance', required
        - `outcome` 'pass' | 'fail' | 'required' | 'unknown', required
        - `detail` string, required
    - `manifest_digest` string, required
    - `content_digest` string, required
    - `connector_digest` string, required
    - `mark` PublicDeclaredMark, required
      - `sha256` string, required
      - `url` string, required
      - `source` 'own' | 'category', required
  - `next_cursor` string

## Other responses

- `400`: Invalid query.
- `503`: Connector catalog unavailable.

---

[API](https://skmtc.dev/runx/apis/runx-hosted-api.md) · [All operations](https://skmtc.dev/runx/apis/runx-hosted-api/llms.txt) · [OpenAPI document](https://skmtc.dev/runx/apis/runx-hosted-api/revisions/6c940d8edacc?raw)