telegram api method · layer 229 · #69da4557
payments.getStarsTransactions
Fetch Telegram Stars transactions.
definition
payments.getStarsTransactions#69da4557 flags:# inbound:flags.0?true outbound:flags.1?true ascending:flags.2?true ton:flags.4?true subscription_id:flags.3?string peer:InputPeer offset:string limit:int = payments.StarsStatus;
parameters
| name | type | description |
|---|---|---|
flags | # | Flags, see TL conditional fields |
inbound | true | If set, fetches only incoming transactions. |
outbound | true | If set, fetches only outgoing transactions. |
ascending | true | Return transactions in ascending order by date (instead of descending order by date). |
ton | true | If set, returns the channel/ad revenue transactions in nanotons, instead. |
subscription_id | string | If set, fetches only transactions for the specified Telegram Star subscription ». |
peer | InputPeer | Fetch the transaction history of the peer (inputPeerSelf or a bot we own). |
offset | string | Offset for pagination, obtained from the returned next_offset, initially an empty string ». |
limit | int | Maximum number of results to return, see pagination |
returns
errors (5)
| code | error | description |
|---|---|---|
| 400 | BUSINESS_CONNECTION_NOT_ALLOWED | This method was invoked over a business connection using invokeWithBusinessConnection, but either (1) we're a user, and users cannot invoke methods over a business connection; (2) we're a bot, but business mode was disabled in @botfather or (3); we're a bot, but this method cannot be invoked over a business connection. |
| 400 | CHAT_ADMIN_REQUIRED | You must be an admin in this chat to do this. |
| 400 | PEER_ID_INVALID | The provided peer id is invalid. |
| 400 | SUBSCRIPTION_ID_INVALID | The specified subscription_id is invalid. |
| 401 | AUTH_KEY_UNREGISTERED | The specified authorization key is not registered in the system (for example, a PFS temporary key has expired). |
history
present in layers 181–229 · constructor id changed 2×
| id | layers |
|---|---|
| #673ac2f9 | 181 |
| #97938d5a | 182–185 |
| #69da4557 | 186–229 |