# Gameball Bots API

**Canonical:** https://apis.io/apis/gameball/gameball-bots-api/  
**Provider:** Gameball — https://apis.io/providers/gameball/  
**Base URL:** https://mcp.gameball.co/mcp  
**Documentation:** https://github.com/gameballers/gameball-mcp-codex

Gameball Bots API is one of 58 APIs that [Gameball](https://apis.io/providers/gameball/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Bots. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, and rate-limit docs.

The Bots API from Gameball — 58 operation(s) for bots.

## Operations (60 of 61)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/Bots/BotSettings` | This Service For Get the Client's BotSettings |
| POST | `/api/v1/Bots/BotSettings` | This Service For Get the Client's BotSettings with Messages |
| GET | `/api/v1/Bots/Notifications/{playerId}` | This Service For Get the Player's Notifications |
| GET | `/api/v1/Bots/family/{familyId}/members` | This Endpoint return a collection of family members, which may include details… |
| POST | `/api/v1/Bots/family/link` | This Service returns a collection of family members, which may include details… |
| GET | `/api/v1/Bots/PlayerInfo` | This Service For Get the Player's Info |
| POST | `/api/v1/Bots/PlayerInfo` | This Service For Get the Player's Info |
| GET | `/api/v1/Bots/PlayerInfo/ReferralCode` | This Service For Get the Player's Info by referral code |
| GET | `/api/v1/Bots/Leaderboard` | This Service For Get the Leaderboard With Top 20 Players with old style |
| GET | `/api/v1/Bots/LeaderboardWithRank` | This Service For Get the Leaderboard With Top 20 Players |
| GET | `/api/v1/Bots/Leaderboard/Community` | This Service For Get the Community Leaderboard |
| GET | `/api/v1/Bots/Challenges/{playerId}` | This Service Returns the player's unlocked challenges and progress percentage |
| GET | `/api/v1/Bots/Challenges` | This Service Returns the player's unlocked challenges and progress percentage |
| GET | `/api/v1/Bots/levels` | This Service Returns the player's levels and progress percentage |
| GET | `/api/v1/Bots/Balance` | This Service For Get Player Balance |
| GET | `/api/v1/Bots/ActionStreakProgress` | This Service For Get Player Progress in a specific Action streak campaign or a… |
| GET | `/api/v1/Bots/mission-progress` | This Service For Get Player Progress in a specific Action streak campaign or a… |
| GET | `/api/v1/Bots/spending-milestone-progress` | This Service For Get Player Progress in a specific spending milestone campaign |
| GET | `/api/v1/Bots/Guest` | This Service used for getting guest view |
| POST | `/api/v1/Bots/Task` | Create api bots task |
| POST | `/api/v1/Bots/guest-spin` | Create api bots guest spin |
| POST | `/api/v1/Bots/guest-game` | Create api bots guest game |
| POST | `/api/v1/Bots/Social` | This Service For Achieve Social Challenges |
| POST | `/api/v1/Bots/streak` | This Service For Achieve daily streak challenge |
| GET | `/api/v1/Bots/email/subscription` | Get api bots email subscription |
| POST | `/api/v1/Bots/email/subscription` | Create api bots email subscription |
| GET | `/api/v1/Bots/Transactions` | Get api bots transactions |
| GET | `/api/v1/Bots/family/{familyId}/transactions` | Endpoint to get family transactions history |
| GET | `/api/v1/Bots/players/{identifier}/referrals` | This endpoint used to list player's referred friends |
| POST | `/api/v1/Bots/SpinRewards` | Create api bots spin rewards |
| POST | `/api/v1/Bots/game-rewards` | Create api bots game rewards |
| DELETE | `/api/v1/Bots/family/{familyId}/members/{memberId}` | Delete api bots family by family id members by member id |
| DELETE | `/api/v1/Bots/family/{familyId}` | Delete api bots family by family id |
| GET | `/api/v1/Bots/appblocks/features` | Get api bots appblocks features |
| POST | `/api/v1/Bots/appblocks/check` | Create api bots appblocks check |
| GET | `/api/v1/Bots/popup-campaign` | Get api bots popup campaign |
| POST | `/api/v1/Bots/popup-campaign/newsletter` | Create api bots popup campaign newsletter |
| POST | `/api/v1/Bots/Quiz` | Create api bots quiz |
| GET | `/api/v1/Bots/surveys/{challengeId}/progress` | Get api bots surveys by challenge id progress |
| POST | `/api/v1/Bots/surveys/{challengeId}/submit` | Create api bots surveys by challenge id submit |
| POST | `/api/v1/Bots/surveys/{challengeId}/submit-guest` | Create api bots surveys by challenge id submit guest |
| POST | `/api/v1/Bots/world-cup-predictions/predictions` | Create api bots world cup predictions predictions |
| GET | `/api/v1/Bots/world-cup-predictions/history` | Get api bots world cup predictions history |
| GET | `/api/v1/Bots/world-cup-predictions/leaderboard` | Get api bots world cup predictions leaderboard |
| GET | `/api/v1/Bots/world-cup-predictions/details` | Get api bots world cup predictions details |
| POST | `/api/v1/Bots/MatchCards` | Create api bots match cards |
| POST | `/api/v1/Bots/Catcher` | Create api bots catcher |
| POST | `/api/v1/Bots/PlayGame` | Create api bots play game |
| POST | `/api/v1/Bots/guest-quiz` | Create api bots guest quiz |
| POST | `/api/v1/Bots/guest-match` | Create api bots guest match |
| POST | `/api/v1/Bots/startGame` | Create api bots start game |
| POST | `/api/v1/Bots/guest-catcher` | Create api bots guest catcher |
| GET | `/api/v1/Bots/CalendarCampaigns` | Get api bots calendar campaigns |
| GET | `/api/v1/Bots/CalendarCampaignLeaderboard` | Get api bots calendar campaign leaderboard |
| GET | `/api/v1/Bots/NonSequentialMissionProgress` | This Service For Get Player Progress in a specific non-sequential mission… |
| GET | `/api/v1/Bots/DailyStreakProgress` | This Service For Get Player Progress in a specific daily streak campaign |
| POST | `/api/v1/Bots/streak-protection/restore` | Streak protection (story #24918): brings a customer's broken check-in streak… |
| POST | `/api/v1/Bots/streak-protection/freeze` | Streak protection (story #24918): pauses a customer's live check-in streak for… |
| POST | `/api/v1/Bots/streak-protection/unfreeze` | Streak protection (story #24918): lifts an active freeze early; the remaining… |
| POST | `/api/v1/Bots/inapp/sync` | Session-start sync for native in-app messages. |

…and 1 more operations. They are listed in full on the page.

## Machine-readable artifacts (9)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/gameball/refs/heads/main/openapi/gameball-bots-api-openapi.yml
- **Documentation** — https://docs.gameball.co
- **APIReference** — https://docs.gameball.co/api-reference/introduction
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/gameball/refs/heads/main/authentication/gameball-authentication.yml
- **RateLimits** — https://raw.githubusercontent.com/api-evangelist/gameball/refs/heads/main/rate-limits/gameball-rate-limits.yml
- **Webhooks** — https://raw.githubusercontent.com/api-evangelist/gameball/refs/heads/main/asyncapi/gameball-webhooks.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/gameball/refs/heads/main/errors/gameball-error-codes.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/gameball/refs/heads/main/errors/gameball-problem-types.yml
- **Sandbox** — https://raw.githubusercontent.com/api-evangelist/gameball/refs/heads/main/sandbox/gameball-sandbox.yml

## Other Gameball APIs (12)

- [Gameball MCP Server](https://apis.io/apis/gameball/gameball-mcp-server/)
- [Gameball API](https://apis.io/apis/gameball/gameball-gameball-api-api/)
- [Gameball Integrations API](https://apis.io/apis/gameball/gameball-integrations-api/)
- [Gameball Actions API](https://apis.io/apis/gameball/gameball-actions-api/)
- [Gameball AI API](https://apis.io/apis/gameball/gameball-ai-api/)
- [Gameball Alerts API](https://apis.io/apis/gameball/gameball-alerts-api/)
- [Gameball Analytics API](https://apis.io/apis/gameball/gameball-analytics-api/)
- [Gameball Audience API](https://apis.io/apis/gameball/gameball-audience-api/)
- [Gameball Audit API](https://apis.io/apis/gameball/gameball-audit-api/)
- [Gameball Audit Runs API](https://apis.io/apis/gameball/gameball-auditruns-api/)
- [Gameball Aws Marketplace API](https://apis.io/apis/gameball/gameball-awsmarketplace-api/)
- [Gameball Billing API](https://apis.io/apis/gameball/gameball-billing-api/)

## Tags

Bots

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/gameball/gameball-bots-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/gameball/.
