---
title: "Query Channel Accounts"
method: GET
path: "/channel_accounts"
tags: ["Channels"]
---

# Query Channel Accounts

`GET /channel_accounts`

Query the third-party channel accounts (Airbnb, Booking.com, etc.) that the operator has connected. Each entry exposes the account identity and current authorization status. Use `id` to fetch a single account.

## Query parameters

- `id` integer
- `channel_type` 'airbnb' | 'booking.com' | 'agoda' | 'expedia' | 'vrbo' | 'trip.com' | 'booking_site' | 'tujia_intl' | 'hostex_direct' | 'tujia' | 'xiaozhu' | 'meituan_bnb' | 'meituan_hotel' | 'muniao' | 'fliggy' | 'zhukeyun' | 'tiktok' | 'xiaohongshu' | 'ctrip' | 'houfy' — The type of the channel. See [Supported Channels](/reference/supported-channels) for more information.
- `offset` integer
- `limit` integer

## Response `200`

A list of channel accounts.

- object
  - `request_id` string, required — Unique identifier for the request.
  - `error_code` integer, required — Numeric error code representing the status of the response. A value of `200` indicates success. <br> See the [Error Codes](/reference/error-manual#error-codes) section for more information.
  - `error_msg` string, required — Message detailing the status of the response.
  - `data` object, required
    - `channel_accounts` object[], required
      - `id` integer — Internal id of the channel account.
      - `channel_type` 'airbnb' | 'booking.com' | 'agoda' | 'expedia' | 'vrbo' | 'trip.com' | 'booking_site' | 'tujia_intl' | 'hostex_direct' | 'tujia' | 'xiaozhu' | 'meituan_bnb' | 'meituan_hotel' | 'muniao' | 'fliggy' | 'zhukeyun' | 'tiktok' | 'xiaohongshu' | 'ctrip' | 'houfy' — The type of the channel. See [Supported Channels](/reference/supported-channels) for more information.
      - `username` string — Login username / identifier on the channel side.
      - `origin_account_id` string — Account id on the channel side (when available).
      - `auth_status` 'active' | 'connecting' | 'disconnected' | 'exception' | 'unknown' — Current authorization / connection status of the channel account.
      - `created_at` string, date-time, nullable — When the account was connected, in ISO 8601 UTC.
    - `total` integer, required — Total number of matching channel accounts.

---

[API](https://skmtc.net/hostex/apis/hostex-api.md) · [All operations](https://skmtc.net/hostex/apis/hostex-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hostex/hostex-api/revisions/a3fa555dee66/schema)