Invites & Rewards API reference

{
  "userId": "876543210987654321",
  "invites": 10,
  "verified": 10,
  "pending": 10,
  "left": 10,
  "fake": 10,
  "bonus": 10,
  "total": 10,
  "rank": 1,
  "season": {
    "id": 98765,
    "number": 7,
    "name": "Example",
    "startsAt": "2026-10-07T12:00:00.000Z",
    "endsAt": "2026-10-07T12:00:00.000Z",
    "invites": 10,
    "rank": 1
  }
}

curl -s "https://console.botgg.app/api/v1/guilds/123456789012345678/invites/members/876543210987654321" \
  -H "Authorization: Bearer $BOTGG_API_KEY"

// Node.js 18+ (built-in fetch) — on your server, never in a browser
const res = await fetch('https://console.botgg.app/api/v1/guilds/123456789012345678/invites/members/876543210987654321', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.BOTGG_API_KEY}`,
  },
});
const data = await res.json();
if (!res.ok) throw new Error(`${res.status} ${data.error}: ${data.message}`);
console.log(data);

import os
import requests

res = requests.get(
    "https://console.botgg.app/api/v1/guilds/123456789012345678/invites/members/876543210987654321",
    headers={
        "Authorization": f"Bearer {os.environ['BOTGG_API_KEY']}",
    },
    timeout=10,
)
data = res.json()
if not res.ok:
    raise RuntimeError(f"{res.status_code} {data['error']}: {data['message']}")
print(data)

{
  "period": "all",
  "season": {
    "id": 98765,
    "number": 7,
    "name": "Example",
    "startsAt": "2026-10-07T12:00:00.000Z",
    "endsAt": "2026-10-07T12:00:00.000Z"
  },
  "items": [
    {
      "rank": 1,
      "userId": "876543210987654321",
      "score": 10,
      "invites": 10,
      "verified": 10,
      "bonus": 10
    }
  ],
  "total": 10,
  "nextCursor": "98700"
}

curl -s "https://console.botgg.app/api/v1/guilds/123456789012345678/invites/leaderboard?period=all&limit=25&cursor=0" \
  -H "Authorization: Bearer $BOTGG_API_KEY"

// Node.js 18+ (built-in fetch) — on your server, never in a browser
const res = await fetch('https://console.botgg.app/api/v1/guilds/123456789012345678/invites/leaderboard?period=all&limit=25&cursor=0', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.BOTGG_API_KEY}`,
  },
});
const data = await res.json();
if (!res.ok) throw new Error(`${res.status} ${data.error}: ${data.message}`);
console.log(data);

import os
import requests

res = requests.get(
    "https://console.botgg.app/api/v1/guilds/123456789012345678/invites/leaderboard",
    headers={
        "Authorization": f"Bearer {os.environ['BOTGG_API_KEY']}",
    },
    params={
        "period": "all",
        "limit": 25,
        "cursor": 0,
    },
    timeout=10,
)
data = res.json()
if not res.ok:
    raise RuntimeError(f"{res.status_code} {data['error']}: {data['message']}")
print(data)

{
  "userId": "876543210987654321",
  "amount": 100,
  "previousBonus": 10,
  "bonus": 10,
  "invites": 10,
  "verified": 10
}

curl -s -X POST "https://console.botgg.app/api/v1/guilds/123456789012345678/invites/members/876543210987654321/bonus" \
  -H "Authorization: Bearer $BOTGG_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"amount":100,"reason":"Tournament prize"}'

// Node.js 18+ (built-in fetch) — on your server, never in a browser
const res = await fetch('https://console.botgg.app/api/v1/guilds/123456789012345678/invites/members/876543210987654321/bonus', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.BOTGG_API_KEY}`,
    'Content-Type': 'application/json',
    'Idempotency-Key': crypto.randomUUID(), // reuse it when you retry this request
  },
  body: JSON.stringify({
    amount: 100,
    reason: 'Tournament prize',
  }),
});
const data = await res.json();
if (!res.ok) throw new Error(`${res.status} ${data.error}: ${data.message}`);
console.log(data);

import os, uuid
import requests

res = requests.post(
    "https://console.botgg.app/api/v1/guilds/123456789012345678/invites/members/876543210987654321/bonus",
    headers={
        "Authorization": f"Bearer {os.environ['BOTGG_API_KEY']}",
        "Idempotency-Key": str(uuid.uuid4()),  # reuse it when you retry this request
    },
    json={
        "amount": 100,
        "reason": "Tournament prize",
    },
    timeout=10,
)
data = res.json()
if not res.ok:
    raise RuntimeError(f"{res.status_code} {data['error']}: {data['message']}")
print(data)