---
title: "Check Telegram status"
method: PATCH
path: "/v1/connect/telegram"
tags: ["Connect"]
---

# Check Telegram status

`PATCH /v1/connect/telegram`

Poll this endpoint to check if a Telegram access code has been used to connect a channel/group. Recommended polling interval: 3 seconds.
Status values: pending (waiting for user), connected (channel/group linked), expired (generate a new code).

## Query parameters

- `code` string, required

## Response `200`

Connection status

- union
  - object
    - `status` 'pending'
    - `expiresAt` string, date-time
    - `expiresIn` integer — Seconds until expiration
  - object
    - `status` 'connected'
    - `chatId` string
    - `chatTitle` string
    - `chatType` 'channel' | 'group' | 'supergroup'
    - `account` object
      - `_id` string
      - `platform` string
      - `username` string
      - `displayName` string
  - object
    - `status` 'expired'
    - `message` string

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `404` — Code not found
- `500` — Internal error

---

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