# OwnedGifts

> Contains the list of gifts received and owned by a user or a chat

**Category:** Telegram Bot API — Types (A-Z)  
**URL:** https://docs.botlify.cloud/ownedgifts  
**Platform:** Botlify Cloud (https://botlify.cloud)  

---

Contains the list of gifts received and owned by a user or a chat.

## Fields

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| total_count | Integer | Always | The total number of gifts owned by the user or the chat |
| gifts | Array of OwnedGift | Always | The list of gifts |
| next_offset | String | Optional | Offset for the next request. If empty, then there are no more results. |

> [!TIP]
> **Botlify Cloud Runtime**
> Credentials are auto-injected in .env — always load them with getenv(): BOT_TOKEN, ADMIN_CHAT_ID, BOT_USERNAME. Main database: database.db (SQLite, WAL mode). Runtime errors: error.log. Quick test: send to $ADMIN_CHAT_ID. Full details: Runtime Reference.