---
title: "/:channel"
method: GET
path: "/tips/{channel}"
tags: ["tips"]
---

# /:channel

`GET /tips/{channel}`

## Request

- Base URL: `https://api.streamelements.com/kappa/v2`
- URL: `https://api.streamelements.com/kappa/v2/tips/{channel}`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://api.streamelements.com/oauth2/authorize`
    - Token URL: `https://api.streamelements.com/oauth2/token`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/streamelements/apis/se-api-docs/docs/tips/:channel/get.ts> (a function with typed inputs; its response is checked against the schema)

List tips

## Path parameters

- `channel` string, required

## Query parameters

- `offset` integer, required
- `limit` integer, required
- `sort` string, required
- `tz` integer, required
- `username` string, required
- `email` string, required
- `after` integer, required
- `before` integer, required
- `message` string, required

## Response `200`

- TipData
  - `donation` Donation, required
    - `user` DonationUser, required
      - `username` string, required
      - `ip` string, nullable
      - `geo` string, nullable, required
      - `email` string, required
    - `message` string, required
    - `amount` integer, required
    - `currency` string, required
  - `provider` string, required
  - `status` string, required
  - `deleted` boolean, required
  - `_id` string, required
  - `channel` string, required
  - `transactionId` string, required
  - `createdAt` string, required
  - `approved` string, required
  - `updatedAt` string, required

## Other responses

- `400`: Bad Request

## Changes

- **2021-02-08** `fb6ec574b6a7`: 4 breaking, 10 info
  - removed the required property `docs` from the response with the `200` status
  - removed the required property `limit` from the response with the `200` status
  - removed the required property `offset` from the response with the `200` status
  - removed the required property `total` from the response with the `200` status
  - …10 more
- **2021-02-08** `8421cd25897f`: 1 info
  - added the optional property `docs/items/donation/user/ip` to the response with the `200` status
- **2021-02-07** `8c745ed2e9e4`: 11 warning
  - the optional response header `Access-Control-Allow-Credentials` removed for the status `200`
  - the optional response header `Access-Control-Expose-Headers` removed for the status `200`
  - the optional response header `ETag` removed for the status `200`
  - the optional response header `Server` removed for the status `200`
  - …7 more

[Operation history](https://skmtc.dev/streamelements/apis/se-api-docs/changes/tips/:channel/get.md)

---

[API](https://skmtc.dev/streamelements/apis/se-api-docs.md) - [All operations](https://skmtc.dev/streamelements/apis/se-api-docs/llms.txt) - [OpenAPI document](https://skmtc.dev/streamelements/apis/se-api-docs/revisions/aa13169b9373?raw)
