List tips
Tips your channel received, with amount, currency, tipper, message and time. Read only.
GET https://cotlet.dev/api/v1/streamelements/tips
read
Returns tips newest first by default, one row per tip. Sort by time or by amount, and filter by username or a date range. Currency is the one set in your Tipping settings. The tool only reads: it moves no money and does not change tip moderation.
Parameters
| Name | Type | Description |
|---|---|---|
| since datetime | datetime | Only tips after this time. |
| until datetime | datetime | Only tips before this time. |
| username string | string | Only tips from this username. |
| sort enum | enum | newest, oldest, amount_desc or amount_asc. Default: newest. |
| limit integer | integer | 1 to 100. Default: 25. |
| cursor string | string | Next page cursor from the previous call. |
Request
curl https://cotlet.dev/api/v1/streamelements/tips \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("streamelements", "list_tips")const result = await cotlet.call('streamelements', 'list_tips');cotlet call streamelements list_tipsExample response
{
"tips": [
{
"tip_id": "tp_77d1c2",
"username": "mika_r",
"amount": 25,
"currency": "USD",
"message": "Great stream, keep it up!",
"created_at": "2026-10-14T20:11:00Z"
}
],
"next_cursor": null
}