Skip to content

Get the Telegram dashboard connection

GET
/integrations/telegram/connection
curl --request GET \
--url https://api.proxyrequest.com/api/v1/integrations/telegram/connection \
--header 'Accept-Language: de' \
--header 'Authorization: Bearer <token>'

Returns connection state and bot details for the authenticated account.

Accept-Language
string
default: en

Preferred language for human-readable API errors. Supported languages: en, ru, uk, de, it, fr, es, zh-hans, ja. Regional language tags and quality weights are accepted; unsupported or omitted values use English.

Examples
de

The operation completed successfully.

Media typeapplication/json
object
available
required
boolean
status
required
string
bot_username
required
string
telegram_username
string
locale
required
string
timezone
required
string
linked_at
string format: date-time
nullable
pending_expires_at
string format: date-time
nullable
Examples
Exampleexample

Example response

{
"available": true,
"status": "status",
"bot_username": "bot username",
"telegram_username": "telegram username",
"locale": "locale",
"timezone": "UTC",
"linked_at": "2026-07-01T12:30:00Z",
"pending_expires_at": "2026-07-01T12:30:00Z"
}

The request is malformed or violates a business rule.

Media typeapplication/json

Validation and API error payload. Field names may be added dynamically; field errors are returned as arrays of human-readable messages.

object
detail
string
non_field_errors
Array<string>
key
additional properties
One of:
string
Examples
Exampleexample

Validation error

{
"non_field_errors": [
"The request could not be processed."
]
}
Content-Language
string

Language used for human-readable errors.

Authentication credentials are missing, expired, or invalid.

Media typeapplication/json

Validation and API error payload. Field names may be added dynamically; field errors are returned as arrays of human-readable messages.

object
detail
string
non_field_errors
Array<string>
key
additional properties
One of:
string
Examples
Exampleexample

Authentication required

{
"detail": "Authentication credentials were not provided."
}
Content-Language
string

Language used for human-readable errors.

The authenticated account cannot perform this operation.

Media typeapplication/json

Validation and API error payload. Field names may be added dynamically; field errors are returned as arrays of human-readable messages.

object
detail
string
non_field_errors
Array<string>
key
additional properties
One of:
string
Examples
Exampleexample

Permission denied

{
"detail": "You do not have permission to perform this action."
}
Content-Language
string

Language used for human-readable errors.