--- title: "Get full user profile" method: GET path: "/v1/users/{peer_id}" tags: ["Identity"] --- # Get full user profile `GET /v1/users/{peer_id}` ## Request - Base URL: `https://telegram155.p.rapidapi.com` - URL: `https://telegram155.p.rapidapi.com/v1/users/{peer_id}` - Auth: none declared Returns the extended profile for a user. Fails with 404 if the user does not exist. ## Path parameters - `peer_id` integer, required ## Response `200` Extended user profile. - UserDetails: Get-full-user envelope. `full_user` carries the extended profile; `users[0]` carries the regular user record for cross-reference. - `chats` Chat[], nullable - `autotranslation` boolean: True if auto-translation is enabled. - `broadcast` boolean: True if this is a broadcast channel. - `date` integer: Unix timestamp the chat was created. - `fake` boolean: True if Telegram has flagged this chat as fake. - `forum` boolean: True if this is a forum (channel with topics). - `gigagroup` boolean: True if this is a gigagroup (broadcast-only supergroup). - `id` integer: Chat peer id. Pass this as `peer_id` to channel/peer endpoints. - `join_request` boolean: True if join requires admin approval. - `join_to_send` boolean: True if posting requires joining. - `left` boolean: True if the viewer has left this chat. - `level` integer: Boost level. - `linked_monoforum_id` integer: Linked monoforum id (if any). - `megagroup` boolean: True if this is a supergroup. - `min` boolean: True if the record is a stripped (min) representation. - `noforwards` boolean: True if content protection (no forwards) is enabled. - `participants_count` integer: Approximate participant count (may be 0 if not exposed). - `photo` Photo: Photo metadata. The image bytes are not returned; clients fetch them out-of-band. - `dcid` integer: Telegram data-center id where the photo lives. - `flags` integer: Bitfield flags. - `has_video` boolean: True if the photo has a video preview. - `photo_id` integer: Photo id. - `stripped_thumb` string: Base64-ish stripped JPEG thumbnail; can be expanded client-side. - `restricted` boolean: True if this chat is restricted (see `restriction_reason`). - `restriction_reason` object[], nullable: Reasons for any restriction. - `scam` boolean: True if Telegram has flagged this chat as a scam. - `signatures` boolean: True if posts show their author. - `slowmode_enabled` boolean: True if slow mode is on. - `title` string: Public display title of the chat. - `username` string: Primary public @username (empty if private). - `usernames` UsernameAlias[], nullable: All public usernames bound to this chat. - `active` boolean: True if the alias is currently active. - `editable` boolean: True if the alias can be edited (only true for the primary one). - `flags` integer: Bitfield of optional Telegram fields. - `username` string: The alias text (no leading @). - `verified` boolean: True if Telegram has verified this chat. - `full_user` UserFull: Extended user profile. Returned inside `full_user` of the get-full-user envelope. - `about` string: Bio text shown on the profile. - `birthday` object, nullable: Birthday metadata, if shared. - `blocked` boolean: True if the viewer has blocked this user. - `bot_info` object, nullable: Bot metadata. Present when the user is a bot. - `business_intro` object, nullable: Telegram Business intro card. - `business_location` object, nullable: Business address & geolocation. - `business_work_hours` object, nullable: Business hours. - `common_chats_count` integer: Number of chats this user shares with the viewer. - `contact_require_premium` boolean: True if only premium users may DM this account. - `fallback_photo` Photo: Photo metadata. The image bytes are not returned; clients fetch them out-of-band. - `dcid` integer: Telegram data-center id where the photo lives. - `flags` integer: Bitfield flags. - `has_video` boolean: True if the photo has a video preview. - `photo_id` integer: Photo id. - `stripped_thumb` string: Base64-ish stripped JPEG thumbnail; can be expanded client-side. - `has_scheduled` boolean: True if scheduled messages exist with this peer. - `id` integer: User peer id (matches the User.id in the same response). - `notify_settings` object, nullable: Notification preferences for this peer. - `personal_channel_id` integer: Linked personal channel id, if any. - `personal_channel_message` integer: Featured message id in the personal channel. - `phone_calls_available` boolean: True if the user accepts phone calls. - `phone_calls_private` boolean: True if call privacy is engaged. - `pinned_msg_id` integer: Pinned message id, or 0 if no pin. - `profile_photo` Photo: Photo metadata. The image bytes are not returned; clients fetch them out-of-band. - `dcid` integer: Telegram data-center id where the photo lives. - `flags` integer: Bitfield flags. - `has_video` boolean: True if the photo has a video preview. - `photo_id` integer: Photo id. - `stripped_thumb` string: Base64-ish stripped JPEG thumbnail; can be expanded client-side. - `settings` object, nullable: Per-peer settings (report buttons, contact requests, etc.). - `sponsored_enabled` boolean: True if sponsored messages are enabled. - `translations_disabled` boolean: True if message translation is opt-out for this peer. - `ttl_period` integer: Self-destruct period (seconds), 0 if disabled. - `video_calls_available` boolean: True if video calls are available. - `voice_messages_forbidden` boolean: True if the user rejects voice messages. - `users` User[] - `bot` boolean: True if this account is a bot. - `close_friend` boolean: Close-friend flag. - `contact` boolean: Contact-relationship flag. - `deleted` boolean: True if the account has been deleted. - `fake` boolean: True if Telegram has flagged this account as fake. - `first_name` string: First name (may be empty for deleted accounts). - `id` integer: User peer id. Pass this as `peer_id` to `/v1/users/{peer_id}`. - `lang_code` string: BCP-47-ish locale code reported by the client (e.g. "en", "ru"). - `last_name` string: Last name (may be empty). - `mutual_contact` boolean: True if the contact relationship is mutual. - `phone` string: Phone number in international format. Empty unless the caller has visibility. - `photo` Photo: Photo metadata. The image bytes are not returned; clients fetch them out-of-band. - `dcid` integer: Telegram data-center id where the photo lives. - `flags` integer: Bitfield flags. - `has_video` boolean: True if the photo has a video preview. - `photo_id` integer: Photo id. - `stripped_thumb` string: Base64-ish stripped JPEG thumbnail; can be expanded client-side. - `premium` boolean: True if this account has Telegram Premium. - `restricted` boolean: True if this user is restricted (see `restriction_reason`). - `restriction_reason` object[], nullable: Reasons for any restriction. Null when not restricted. - `scam` boolean: True if Telegram has flagged this account as a scam. - `status` object, nullable: Online status object (varies by privacy settings). - `username` string: Primary public @username (empty if the user has none). - `usernames` UsernameAlias[], nullable: All public usernames bound to this user (some accounts collect multiple). - `active` boolean: True if the alias is currently active. - `editable` boolean: True if the alias can be edited (only true for the primary one). - `flags` integer: Bitfield of optional Telegram fields. - `username` string: The alias text (no leading @). - `verified` boolean: True if Telegram has verified this user. ## Other responses - `400`: Invalid request — bad path or query parameter. - `404`: Not found. - `409`: The peer id could not be found, so no access hash exists for it. Not transient: seed the id via GET /v1/usernames/{username}, GET /v1/phones/{phone}, or by encountering it in a chat, then retry. Raw MTProto ids only: a Bot-API id like -1001234567890 must be sent as 1234567890 (strip the leading -100), and -123456789 as 123456789. When the request carries such an id, the hint names the exact id to retry with. - `429`: Rate limit exceeded. - `503`: Service temporarily unavailable. - `504`: Request timed out. --- [API](https://skmtc.dev/tgatlas/apis/tgatlas-telegram-channel-data-api.md) · [All operations](https://skmtc.dev/tgatlas/apis/tgatlas-telegram-channel-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tgatlas/apis/tgatlas-telegram-channel-data-api/revisions/875ce0155fe9?raw)