API reference

Read the Telegram notification status

Where the creator's sale notifications currently go: their saved handle, whether a personal chat is connected, and whether a group/channel is connected.

View as MarkdownUpdated Aug 19, 2026

GET/api/external/notifications

Where the creator's sale notifications currently go: their saved handle, whether a personal chat is connected, and whether a group/channel is connected.

Read-only and safe. Use it before any write in this group so you never clobber an existing setup.

Authentication

Send the creator's API key as a bearer token: Authorization: Bearer dpfn_…. See Authentication & API keys.

Responses

200The current connection state.

Name	Type	Description
`telegramHandle`	string \| null	The creator’s saved Telegram @handle (without @), or null.
`personalConnected`	boolean	True when a personal chat id is registered — sale notifications DM the creator.
`groupConnected`	boolean	True when a group/channel is registered for notifications.
`groupChatId`	string \| null	The registered group chat id (e.g. "-100…"), or null.
`groupName`	string \| null	The registered group’s title, or null.

Example response

{
  "telegramHandle": "valeria_tg",
  "personalConnected": true,
  "groupConnected": false,
  "groupChatId": null,
  "groupName": null
}

Errors

Status	Body	When
401	`{"error":"Unauthorized","code":"unauthorized"}`	Missing or invalid API key.
404	`{"error":"User not found"}`	The key’s account no longer exists.

Rate limiting

Every response carries the X-RateLimit-Tier header and, on limited tiers, the per-minute and per-day trios — read X-RateLimit-Remaining and X-RateLimit-Reset instead of hardcoding limits. Details in Rate limits.

Code samples

curl "https://www.dropfans.io/api/external/notifications" \
  -H "Authorization: Bearer $DROPFANS_API_KEY"

const res = await fetch(`https://www.dropfans.io/api/external/notifications`, {
  headers: {
    Authorization: `Bearer ${process.env.DROPFANS_API_KEY}`,
  },
});
console.log(await res.json());

import os
import requests

res = requests.get(
    "https://www.dropfans.io/api/external/notifications",
    headers={"Authorization": f"Bearer {os.environ['DROPFANS_API_KEY']}"},
)
print(res.json())

← Previous

Canonical profile, tip, subscribe and buy links

Update Telegram notification settings

Questions? [email protected]