List channels

GET /api/v1/forward/channels Returns Channel records owned by the authenticated account.

Headers

Header	Required	Description
`Authorization`	Yes	`Bearer <PAT or SAT>`

Query parameters

Parameter	Type	Required	Default	Description
`channel_type`	string	No	-	Filter by `wechat`, `wecom`, `feishu`, or `dingtalk`.
`enabled`	boolean	No	-	Filter by manual enable state.
`binding_status`	string	No	-	Filter by `unbound`, `bound`, or `expired`.
`identity_id`	string	No	-	Filter by Forward Identity ID.
`template_id`	string	No	-	Filter by Forward Template ID.
`limit`	integer	No	20	Items per page. Maximum 100.
`after_id`	string	No	-	Cursor for records after the given Channel ID.
`before_id`	string	No	-	Cursor for records before the given Channel ID.

Example request

curl -s -X GET 'https://api.qoder.com/api/v1/forward/channels?identity_id=idn_019eabc123&limit=20' \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

Example response

HTTP 200 OK

{
  "data": [
    {
      "id": "channel_019eabc123",
      "type": "channel",
      "identity_id": "idn_019eabc123",
      "identity_resolution": {
        "mode": "fixed"
      },
      "template_id": "tmpl_support",
      "channel_type": "feishu",
      "name": "Support Feishu channel",
      "enabled": true,
      "binding_status": "bound",
      "channel_config": {
        "response_options": {
          "include_tool_calls": false,
          "include_thinking": false
        }
      },
      "created_at": "2026-06-18T10:00:00Z",
      "updated_at": "2026-06-18T10:00:00Z"
    }
  ],
  "first_id": "channel_019eabc123",
  "last_id": "channel_019eabc123",
  "has_more": false
}

Response fields

Field	Type	Description
`data`	array	Channel objects on the current page.
`first_id`	string\|null	ID of the first Channel on this page.
`last_id`	string\|null	ID of the last Channel on this page.
`has_more`	boolean	Whether more records remain.

Error codes

HTTP	Type	Trigger
400	`invalid_request_error`	Pagination parameters are invalid.
400	`invalid_request_error`	Channel type filter is unsupported.
401	`authentication_error`	PAT or SAT is invalid or expired.

Notes

after_id and before_id are mutually exclusive.
Channels are returned only inside the caller's account boundary.
Each Channel object includes identity_resolution.mode. In pairing mode, identity_id and template_id are both null.

List channels

Headers

Query parameters

Example request

Example response

Response fields

Error codes

Notes

Create a channel

Get a channel

​Headers

​Query parameters

​Example request

​Example response

​Response fields

​Error codes

​Notes

​Related

Create a channel

Get a channel

Headers

Query parameters

Example request

Example response

Response fields

Error codes

Notes

Related