# Search channels

Lists channel instances owned by the organization, with optional filtering and pagination.

Request:
category           - Optional category filter (ORIGIN, OBSERVATION, DELIVERY).
pagination         - Optional Pagination cursor and page size.
includeDeleted    - When true, includes soft-deleted channels in the results.

Response:
channelInstances  - List of ChannelInstance objects including id, name, status, settings,
scan state, and timestamps.
pageCursor        - Opaque cursor for the next page. Absent when there are no further results.

Endpoint: POST /api/v1/channel/list-channels
Version: 3.0
Security: bearerAuth

## Request fields (application/json):

  - `category` (integer)
    Enum: 0, 1, 2, 3

  - `channelTypeId` (string)
    Rule data fields

  - `pagination` (object)

  - `pagination.pageCursor` (string)
    Rule data fields

  - `pagination.maxSize` (integer)

  - `includeDeleted` (boolean)

## Response 200 fields (application/json):

  - `channelInstances` (array)

  - `channelInstances.id` (string)
    Rule data fields

  - `channelInstances.channelTypeId` (string)
    Rule data fields

  - `channelInstances.name` (string)
    Rule data fields

  - `channelInstances.description` (string)
    Rule data fields

  - `channelInstances.settings` (any)

  - `channelInstances.hasFailed` (boolean)

  - `channelInstances.status` (integer)
    Enum: 0, 1, 2, 3, 4

  - `channelInstances.scanState` (string)
    Rule data fields

  - `channelInstances.weightage` (number)

  - `channelInstances.createdAt` (object)

  - `channelInstances.createdAt.seconds` (integer)

  - `channelInstances.createdAt.nanos` (integer)

  - `channelInstances.updatedAt` (object)

  - `channelInstances.deletedAt` (object)

  - `pageCursor` (string)
    Rule data fields

## Response 400 fields (application/json):

  - `message` (string)

## Response 401 fields (application/json):

  - `message` (string)

## Response 403 fields (application/json):

  - `message` (string)

## Response 404 fields (application/json):

  - `message` (string)

## Response 409 fields (application/json):

  - `message` (string)

## Response 429 fields (application/json):

  - `message` (string)

## Response 499 fields (application/json):

  - `message` (string)

## Response 500 fields (application/json):

  - `message` (string)

## Response 501 fields (application/json):

  - `message` (string)

## Response 503 fields (application/json):

  - `message` (string)

## Response 504 fields (application/json):

  - `message` (string)