---
title: "Get a channel by ID"
method: GET
path: "/api/channel/{id}"
tags: ["channel"]
---

# Get a channel by ID

`GET /api/channel/{id}`

Returns detailed information about a specific channel

## Path parameters

- `id` integer, required

## Response `200`

OK

- object
  - `data` ModelChannel
    - `balance` number
    - `balance_threshold` number
    - `balance_updated_at` string
    - `base_url` string
    - `channel_tests` ModelChannelTest[]
      - `actual_model` string
      - `channel_id` integer
      - `channel_name` string
      - `channel_type` 1 | 3 | 4 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | 32 | 33 | 34 | 35 | 36 | 37 | 40 | 41 | 42 | 43 | 44 | 45 | 46 | 47 | 48 | 49 | 50 | 51 | 52 | 53 | 54 | 55
      - `code` integer
      - `mode` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30
      - `model` string
      - `response` string
      - `success` boolean
      - `test_at` string
      - `took` number
    - `configs` ModelChannelConfigs
    - `created_at` string
    - `enabled_auto_balance_check` boolean
    - `enabled_no_permission_ban` boolean
    - `id` integer
    - `key` string
    - `last_test_error_at` string
    - `max_error_rate` number
    - `model_mapping` object
    - `models` string[]
    - `name` string
    - `priority` integer
    - `proxy_url` string
    - `request_count` integer
    - `retry_count` integer
    - `sets` string[]
    - `skip_tls_verify` boolean
    - `status` integer
    - `type` 1 | 3 | 4 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | 32 | 33 | 34 | 35 | 36 | 37 | 40 | 41 | 42 | 43 | 44 | 45 | 46 | 47 | 48 | 49 | 50 | 51 | 52 | 53 | 54 | 55
    - `used_amount` number
    - `warn_error_rate` number
  - `message` string
  - `success` boolean

---

[API](https://skmtc.net/labring/apis/ai-proxy-swagger-api.md) · [All operations](https://skmtc.net/labring/apis/ai-proxy-swagger-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/labring/ai-proxy-swagger-api/revisions/696faf563b42/schema)
