---
title: "Get Destinations"
method: GET
path: "/destinations"
tags: ["Destinations"]
---

# Get Destinations

`GET /destinations`

## Query parameters

- `page` integer — Page number (1-indexed)
- `page_size` integer — Number of results per page (max 100)
- `sort` string, nullable — Sort field. Can be a DB field (name, created_at) or a metric field (latency, connector_status, recordsLag)
- `sort_dir` 'asc' | 'desc' — Sort direction for list/pagination requests. Example: >>> SortDirectionEnum.asc 'asc' >>> sort_dir = SortDirectionEnum.desc >>> f"ORDER BY name {sort_dir.upper()}" 'ORDER BY name DESC'
- `last_seen_offsets` union — Last seen offsets for topic messages pagination (cursor-based)
  - string
  - object
- `first_seen_offsets` union — First seen offsets for topic messages pagination (cursor-based)
  - string
  - object
- `id` string, nullable
- `partial_name` string, nullable
- `connector` string, nullable — Filter by connector type. Comma-separated for multiple connectors (e.g., 'snowflake', 'snowflake,bigquery,clickhouse')
- `status` string, nullable — Filter by connector status. Comma-separated for multiple statuses (e.g., 'Active', 'Active,Paused'). Valid statuses: Active, Broken, Paused, Stopped, Starting, Unassigned, Unknown
- `lag` string, nullable — Filter by consumer lag (records behind). Format: 'operator:value' (e.g., 'gt:100', 'lt:50'). Valid operators: gt (>), lt (<), gte (>=), lte (<=), eq (=), ne (!=)
- `tag_ids` string, nullable — Filter by tag IDs. Comma-separated list (e.g., 'tag1,tag2'). Use with tag_filter_operation to control AND/OR logic.
- `tag_filter_operation` 'and' | 'or', nullable — Tag filter logic: 'or' (default) matches any tag, 'and' matches all tags.

## Request body

- DestinationsPaginatedReqBody — Body model for POST /destinations/search requests. Supports large lists of filter values that would exceed URL length limits when using GET. Body parameters take precedence over query parameters when both are provided.
  - `connector` union — List of connector types (as array) or comma-separated string. Body takes precedence over query params.
    - string[]
    - string
  - `status` union — List of statuses (as array) or comma-separated string. Body takes precedence over query params.
    - string[]
    - string
  - `tag_ids` union — List of tag IDs (as array) or comma-separated string. Body takes precedence over query params.
    - string[]
    - string
  - `tag_filter_operation` 'and' | 'or', nullable — Tag filter logic: 'or' (default) matches any tag, 'and' matches all tags. Body takes precedence over query params.

## Response `200`

Successful Response

- DestinationsPaginatedRes — Get paginated destinations response.
  - `page` integer — Current page number
  - `page_size` integer — Results per page
  - `total` integer, nullable — Total number of results
  - `has_next` boolean, nullable — Whether more pages exist
  - `result` DestinationConnector[], required
    - `name` string, nullable — User-defined connector name
    - `connector` string, nullable — Connector type (e.g., 'snowflake', 'bigquery', 'clickhouse')
    - `id` string, nullable — Unique identifier
    - `connector_display_name` string, nullable — Human-readable connector type name
    - `created_timestamp` union — Creation timestamp (ISO 8601)
      - string
      - string, date-time
    - `sub_id` string, nullable — Subscription identifier
    - `tenant_id` string, nullable — Tenant identifier for multi-tenancy
    - `config` object, nullable — Connector configuration parameters
    - `topic_ids` union[], nullable — List of associated topic identifiers
      - union
        - string
        - integer
    - `topic_map` object, nullable — Mapping of topics to their partitions or related entities
    - `topics` union[], nullable — List of topic names
      - union
        - string
        - integer
    - `tasks` integer[], nullable — List of task identifiers
    - `connector_status` string, nullable — Current status: Active, Paused, Stopped, Broken, Starting, Unassigned, Unknown, Pending
    - `desired_state` string, nullable — Desired state: Pending, Active, Paused, Stopped
    - `kc_cluster_id` string, nullable — KC cluster this connector is deployed to. None means default cluster.
    - `task_statuses` object, nullable — Status information for each connector task
    - `tags` string[], nullable — List of tag IDs assigned to this destination

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/streamkap/apis/streamkap-rest-api.md) · [All operations](https://skmtc.net/streamkap/apis/streamkap-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/streamkap/streamkap-rest-api/versions/8aea6143d003/schema)