CRMchat APIBeta
Telegram APIPayments

payments.getStarGiftAuctionAcquiredGifts

POST
/workspaces/{workspaceId}/telegram-accounts/{accountId}/call/payments.getStarGiftAuctionAcquiredGifts

Fetches all the gifts that the current user won in an auction.

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*

Fetches all the gifts that the current user won in an auction.

Response Body

application/json

application/json

curl -X POST "https://example.com/workspaces/string/telegram-accounts/string/call/payments.getStarGiftAuctionAcquiredGifts" \  -H "Content-Type: application/json" \  -d '{    "params": {      "giftId": "string"    }  }'
{  "result": {    "_": "payments.starGiftAuctionAcquiredGifts",    "gifts": [      {        "_": "starGiftAuctionAcquiredGift",        "nameHidden": true,        "peer": {          "_": "peerUser",          "userId": 0        },        "date": 0,        "bidAmount": "string",        "round": 0,        "pos": 0,        "message": {          "_": "textWithEntities",          "text": "string",          "entities": [            {              "_": "messageEntityUnknown",              "offset": 0,              "length": 0            }          ]        },        "giftNum": 0      }    ],    "users": [      {        "_": "userEmpty",        "id": 0      }    ],    "chats": [      {        "_": "chatEmpty",        "id": 0      }    ]  }}

getStarGiftActiveAuctions

Fetches all currently active [gift auctions](https://core.telegram.org/api/auctions) the user has ever bid on (including auctions where the user was outbid and their bid was returned), as long as the auction hasn't ended yet. This method is primarily used to display an auction badge in the chat list immediately on app startup, without waiting for real-time `RawUpdateStarGiftAuctionState` updates to arrive: the client calls it to discover which auctions the user is participating in and show the badge proactively. To instead fetch the full state of a single auction, subscribe to its real-time updates and render the detailed auction UI (typically when the user opens a specific auction), use `payments.RawGetStarGiftAuctionStateRequest`.

getStarGiftAuctionState

Returns info about a [collectible gift auction »](https://core.telegram.org/api/auctions); also subscribes the user to auction updates, see [here »](https://core.telegram.org/api/auctions) for more info on the full flow.