Telegram APIUsers
users.getFullUser
Returns extended user info by ID.
Authorization
bearerAuth AuthorizationBearer <token>
In: header
Path Parameters
workspaceId*string
Workspace ID
accountId*string
Telegram account ID
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
params*
Returns extended user info by ID.
Response Body
application/json
application/json
curl -X POST "https://example.com/workspaces/string/telegram-accounts/string/call/users.getFullUser" \ -H "Content-Type: application/json" \ -d '{ "params": { "id": { "_": "inputUserEmpty" } } }'{ "result": { "_": "users.userFull", "fullUser": { "_": "userFull", "blocked": true, "phoneCallsAvailable": true, "phoneCallsPrivate": true, "canPinMessage": true, "hasScheduled": true, "videoCallsAvailable": true, "voiceMessagesForbidden": true, "translationsDisabled": true, "storiesPinnedAvailable": true, "blockedMyStoriesFrom": true, "wallpaperOverridden": true, "contactRequirePremium": true, "readDatesPrivate": true, "sponsoredEnabled": true, "canViewRevenue": true, "botCanManageEmojiStatus": true, "displayGiftsButton": true, "noforwardsMyEnabled": true, "noforwardsPeerEnabled": true, "unofficialSecurityRisk": true, "id": 0, "about": "string", "settings": { "_": "peerSettings", "reportSpam": true, "addContact": true, "blockContact": true, "shareContact": true, "needContactsException": true, "reportGeo": true, "autoarchived": true, "inviteMembers": true, "requestChatBroadcast": true, "businessBotPaused": true, "businessBotCanReply": true, "geoDistance": 0, "requestChatTitle": "string", "requestChatDate": 0, "businessBotId": 0, "businessBotManageUrl": "string", "chargePaidMessageStars": "string", "registrationMonth": "string", "phoneCountry": "string", "nameChangeDate": 0, "photoChangeDate": 0 }, "personalPhoto": { "_": "photoEmpty", "id": "string" }, "profilePhoto": { "_": "photoEmpty", "id": "string" }, "fallbackPhoto": { "_": "photoEmpty", "id": "string" }, "notifySettings": { "_": "peerNotifySettings", "showPreviews": true, "silent": true, "muteUntil": 0, "iosSound": { "_": "notificationSoundDefault" }, "androidSound": { "_": "notificationSoundDefault" }, "otherSound": { "_": "notificationSoundDefault" }, "storiesMuted": true, "storiesHideSender": true, "storiesIosSound": { "_": "notificationSoundDefault" }, "storiesAndroidSound": { "_": "notificationSoundDefault" }, "storiesOtherSound": { "_": "notificationSoundDefault" } }, "botInfo": { "_": "botInfo", "hasPreviewMedias": true, "userId": 0, "description": "string", "descriptionPhoto": { "_": "photoEmpty", "id": "string" }, "descriptionDocument": { "_": "documentEmpty", "id": "string" }, "commands": [ { "_": "botCommand", "ephemeral": true, "command": "string", "description": "string" } ], "menuButton": { "_": "botMenuButtonDefault" }, "privacyPolicyUrl": "string", "appSettings": { "_": "botAppSettings", "placeholderPath": "string", "backgroundColor": 0, "backgroundDarkColor": 0, "headerColor": 0, "headerDarkColor": 0 }, "verifierSettings": { "_": "botVerifierSettings", "canModifyCustomDescription": true, "icon": "string", "company": "string", "customDescription": "string" } }, "pinnedMsgId": 0, "commonChatsCount": 0, "folderId": 0, "ttlPeriod": 0, "theme": { "_": "chatTheme", "emoticon": "string" }, "privateForwardName": "string", "botGroupAdminRights": { "_": "chatAdminRights", "changeInfo": true, "postMessages": true, "editMessages": true, "deleteMessages": true, "banUsers": true, "inviteUsers": true, "pinMessages": true, "addAdmins": true, "anonymous": true, "manageCall": true, "other": true, "manageTopics": true, "postStories": true, "editStories": true, "deleteStories": true, "manageDirectMessages": true, "manageRanks": true, "manageLinkedPeers": true }, "botBroadcastAdminRights": { "_": "chatAdminRights", "changeInfo": true, "postMessages": true, "editMessages": true, "deleteMessages": true, "banUsers": true, "inviteUsers": true, "pinMessages": true, "addAdmins": true, "anonymous": true, "manageCall": true, "other": true, "manageTopics": true, "postStories": true, "editStories": true, "deleteStories": true, "manageDirectMessages": true, "manageRanks": true, "manageLinkedPeers": true }, "wallpaper": { "_": "wallPaper", "id": "string", "creator": true, "default": true, "pattern": true, "dark": true, "accessHash": "string", "slug": "string", "document": { "_": "documentEmpty", "id": "string" }, "settings": { "_": "wallPaperSettings", "blur": true, "motion": true, "backgroundColor": 0, "secondBackgroundColor": 0, "thirdBackgroundColor": 0, "fourthBackgroundColor": 0, "intensity": 0, "rotation": 0, "emoticon": "string" } }, "stories": { "_": "peerStories", "peer": { "_": "peerUser", "userId": 0 }, "maxReadId": 0, "stories": [ { "_": "storyItemDeleted", "id": 0 } ] }, "businessWorkHours": { "_": "businessWorkHours", "openNow": true, "timezoneId": "string", "weeklyOpen": [ { "_": "businessWeeklyOpen", "startMinute": 0, "endMinute": 0 } ] }, "businessLocation": { "_": "businessLocation", "geoPoint": { "_": "geoPointEmpty" }, "address": "string" }, "businessGreetingMessage": { "_": "businessGreetingMessage", "shortcutId": 0, "recipients": { "_": "businessRecipients", "existingChats": true, "newChats": true, "contacts": true, "nonContacts": true, "excludeSelected": true, "users": [ 0 ] }, "noActivityDays": 0 }, "businessAwayMessage": { "_": "businessAwayMessage", "offlineOnly": true, "shortcutId": 0, "schedule": { "_": "businessAwayMessageScheduleAlways" }, "recipients": { "_": "businessRecipients", "existingChats": true, "newChats": true, "contacts": true, "nonContacts": true, "excludeSelected": true, "users": [ 0 ] } }, "businessIntro": { "_": "businessIntro", "title": "string", "description": "string", "sticker": { "_": "documentEmpty", "id": "string" } }, "birthday": { "_": "birthday", "day": 0, "month": 0, "year": 0 }, "personalChannelId": 0, "personalChannelMessage": 0, "stargiftsCount": 0, "starrefProgram": { "_": "starRefProgram", "botId": 0, "commissionPermille": 0, "durationMonths": 0, "endDate": 0, "dailyRevenuePerUser": { "_": "starsAmount", "amount": "string", "nanos": 0 } }, "botVerification": { "_": "botVerification", "botId": 0, "icon": "string", "description": "string" }, "sendPaidMessagesStars": "string", "disallowedGifts": { "_": "disallowedGiftsSettings", "disallowUnlimitedStargifts": true, "disallowLimitedStargifts": true, "disallowUniqueStargifts": true, "disallowPremiumGifts": true, "disallowStargiftsFromChannels": true }, "starsRating": { "_": "starsRating", "level": 0, "currentLevelStars": "string", "stars": "string", "nextLevelStars": "string" }, "starsMyPendingRating": { "_": "starsRating", "level": 0, "currentLevelStars": "string", "stars": "string", "nextLevelStars": "string" }, "starsMyPendingRatingDate": 0, "mainTab": { "_": "profileTabPosts" }, "savedMusic": { "_": "documentEmpty", "id": "string" }, "note": { "_": "textWithEntities", "text": "string", "entities": [ { "_": "messageEntityUnknown", "offset": 0, "length": 0 } ] }, "botManagerId": 0 }, "chats": [ { "_": "chatEmpty", "id": 0 } ], "users": [ { "_": "userEmpty", "id": 0 } ] }}saveFilePart
Saves a part of file for further sending to one of the methods.
getRequirementsToContact
Check whether we can write to the specified users, used to implement bulk checks for [Premium-only messages »](https://core.telegram.org/api/privacy#require-premium-for-new-non-contact-users) and [paid messages »](https://core.telegram.org/api/paid-messages). For each input user, returns a [RequirementToContact](https://core.telegram.org/type/RequirementToContact) constructor (at the same offset in the vector) containing requirements to contact them.