Skip to main content
GET
/
twitch
/
badges
/
global
curl https://teambattles.gg/api/v1/twitch/badges/global \
  -H "Authorization: Bearer tb_your_api_key"
{
  "badges": [
    {
      "set_id": "<string>",
      "versions": [
        {
          "id": "<string>",
          "image_url_1x": "<string>",
          "image_url_2x": "<string>",
          "image_url_4x": "<string>",
          "title": "<string>",
          "description": "<string>",
          "click_action": "<string>",
          "click_url": "<string>"
        }
      ]
    }
  ],
  "timestamp": "2023-11-07T05:31:56Z"
}
curl https://teambattles.gg/api/v1/twitch/badges/global \
  -H "Authorization: Bearer tb_your_api_key"

Prerequisites

This endpoint requires:
  1. The connections.twitch permission enabled on your API key
  2. A Twitch account connected to your TeamBattles account
If you haven’t connected your Twitch account, go to Settings > Connections in the TeamBattles app.

What Are Global Badges?

Global badges are Twitch badges available across all channels. Examples include:
  • Twitch Staff - Twitch employees
  • Twitch Admin - Twitch administrators
  • Broadcaster - The channel owner
  • Moderator - Channel moderators
  • VIP - VIP users
  • Subscriber - Default subscriber badges
  • Prime Gaming - Amazon Prime members
  • Verified - Verified accounts

Caching

The response includes a Cache-Control: public, max-age=3600 header, indicating the data can be cached for 1 hour. Badge images rarely change, so caching is recommended.

Use with Channel Badges

For a complete chat badge display, you’ll typically need both:
  1. Global badges (this endpoint) - For universal badges like moderator, VIP
  2. Channel badges (Get Channel Badges) - For channel-specific subscriber badges
When displaying badges, check the channel badges first, then fall back to global badges for the same set_id.

Authorizations

Authorization
string
header
required

API key authentication. Generate an API key from Settings > Developer in the TeamBattles app. Format: tb_xxxxxxxx...

Response

Successful response

badges
object[]
timestamp
string<date-time>

Response timestamp (ISO 8601)