> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrape.st/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Telegram Subscription

> Retrieve the Telegram subscription for your API key

Returns the Telegram chat subscription registered for the calling API key, or `null` if none exists.

## Response

<ResponseField name="data" type="object | null">
  The subscription: `id`, `apiKey`, `chatId`, `name`, `status`. `null` when no
  chat is subscribed.
</ResponseField>

<ResponseField name="message" type="string">
  `Subscription retrieved` or `No subscription for this API key`.
</ResponseField>

<RequestExample>
  ```bash theme={null}
  curl -X GET https://scrape.st/tg_subscription \
    -H "x-api-key: YOUR_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "data": {
      "id": "clx0...",
      "apiKey": "YOUR_API_KEY",
      "chatId": "-1001234567890",
      "name": "alerts",
      "status": "ACTIVE"
    },
    "message": "Subscription retrieved"
  }
  ```
</ResponseExample>