> For the complete documentation index, see [llms.txt](https://docs.cekat.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cekat.ai/api-documentation/chat/connected-platforms/list-inboxes.md).

# List inboxes

Lists the channels connected to your business (WhatsApp, Instagram, Messenger, live chat and others), newest first. Deleted inboxes are not included.

```json
{"openapi":"3.0.3","info":{"title":"Cekat Open API","version":"1.0.0"},"tags":[{"name":"Connected Platforms","description":"Each connected channel is an inbox. Use an inbox's `id` as `inbox_id` in other endpoints, for example to create or send WhatsApp templates."}],"servers":[{"url":"https://api.cekat.ai","description":"Production"}],"security":[{"CekatApiKey":[]},{"BearerAuth":[]}],"components":{"securitySchemes":{"CekatApiKey":{"type":"apiKey","in":"header","name":"api_key","description":"Your business's Cekat API key, from **Settings → Developers & API** in the Cekat dashboard (https://chat.cekat.ai/developers?section=apikeys). Available on the Business and Enterprise plans."},"BearerAuth":{"type":"http","scheme":"bearer","description":"The same Cekat API key, sent as `Authorization: Bearer YOUR_API_KEY`. Accepted only by endpoints under `/api/...`."}},"parameters":{"StartDate":{"name":"start_date","in":"query","required":false,"description":"Only include items created on or after this date (`YYYY-MM-DD`). Cannot be combined with `start_datetime`.","schema":{"type":"string","format":"date"}},"EndDate":{"name":"end_date","in":"query","required":false,"description":"Only include items created on or before the end of this date (`YYYY-MM-DD`). Cannot be combined with `end_datetime`.","schema":{"type":"string","format":"date"}},"StartDatetime":{"name":"start_datetime","in":"query","required":false,"description":"Only include items created at or after this time (`YYYY-MM-DDTHH:mm:ss`, optional offset such as `+07:00` or `Z`). Cannot be combined with `start_date`.","schema":{"type":"string"}},"EndDatetime":{"name":"end_datetime","in":"query","required":false,"description":"Only include items created at or before this time (`YYYY-MM-DDTHH:mm:ss`, optional offset). Cannot be combined with `end_date`.","schema":{"type":"string"}},"Version":{"name":"version","in":"query","required":false,"description":"Response format version in `YYYY-MM-DD` format. Use `2026-05-22` or later to get `created_at` as an ISO 8601 UTC timestamp.","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"UserTimezone":{"name":"X-User-Timezone","in":"header","required":false,"description":"IANA time zone used to read date filters that have no offset. Defaults to `Asia/Jakarta`.","schema":{"type":"string"}}},"schemas":{"Inbox":{"type":"object","description":"A connected channel (inbox).","properties":{"id":{"type":"string","format":"uuid","description":"Inbox ID. Use it as `inbox_id` in other endpoints."},"business_id":{"type":"string","format":"uuid"},"name":{"type":"string"},"description":{"type":"string","nullable":true},"phone_number":{"type":"string","nullable":true,"description":"The channel's phone number, for WhatsApp inboxes."},"type":{"type":"string","description":"Channel type.","enum":["whatsapp","whatsapp_mobile","livechat","instagram","messenger","tokopedia","shopee","custom_api","instagram_comment","facebook_comment","email","tiktok_business_messaging","google_play_review"]},"status":{"type":"string","enum":["active","inactive","processing"]},"is_whatsapp_coexistence":{"type":"boolean","nullable":true,"description":"True when the WhatsApp number is also used in the WhatsApp Business app (coexistence)."},"auto_reassign":{"type":"boolean","nullable":true},"ai_agent_id":{"type":"string","format":"uuid","nullable":true,"description":"AI agent assigned to the inbox, if any."},"ai_agent_name":{"type":"string","nullable":true},"flow_mode":{"type":"boolean","nullable":true,"description":"True when the inbox replies with a flow instead of an AI agent."},"flow_id":{"type":"string","format":"uuid","nullable":true},"flow_name":{"type":"string","nullable":true},"created_at":{"type":"string","description":"Creation time. ISO 8601 UTC with `version=2026-05-22` or later; otherwise Asia/Jakarta local time without an offset."}}},"Pagination":{"type":"object","properties":{"current_page":{"type":"integer"},"total_page":{"type":"integer"},"total_items":{"type":"integer"}}},"ApiError":{"type":"object","description":"Error body returned by the `/api/...` endpoints.","properties":{"success":{"type":"boolean"},"message":{"type":"string"},"statusCode":{"type":"integer"},"error":{"type":"object","properties":{"message":{"type":"string"}}},"correlationId":{"type":"string","description":"Request ID. Include it when contacting Cekat support."}}},"RateLimitError":{"type":"object","properties":{"message":{"type":"string"}}}},"responses":{"ApiBadRequest":{"description":"The request is invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"ApiUnauthorized":{"description":"The API key is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"TooManyRequests":{"description":"Rate limit exceeded. Wait and retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}}}},"paths":{"/api/inboxes":{"get":{"tags":["Connected Platforms"],"operationId":"ListInboxes","summary":"List inboxes","description":"Lists the channels connected to your business (WhatsApp, Instagram, Messenger, live chat and others), newest first. Deleted inboxes are not included.","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":10}},{"$ref":"#/components/parameters/StartDate"},{"$ref":"#/components/parameters/EndDate"},{"$ref":"#/components/parameters/StartDatetime"},{"$ref":"#/components/parameters/EndDatetime"},{"$ref":"#/components/parameters/Version"},{"$ref":"#/components/parameters/UserTimezone"}],"responses":{"200":{"description":"A page of inboxes.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Inbox"}},"metadata":{"type":"object","properties":{"pagination":{"$ref":"#/components/schemas/Pagination"}}}}}}}},"400":{"$ref":"#/components/responses/ApiBadRequest"},"401":{"$ref":"#/components/responses/ApiUnauthorized"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}}}}
```