Gameball

Gameball is a customer loyalty and gamification platform that helps consumer brands turn one-time buyers into repeat customers through points, VIP tiers, referrals, cashback, coupons, reward campaigns and gamified experiences (spin the wheel, scratch & win, missions, stamps) plus email/SMS/push communication and automation campaigns. It exposes a RESTful API (base https://api.gameball.co/api/{version}) secured with APIKey and SecretKey headers — v4.1 "Secure Integration Mode" is the documented current release, though the only OpenAPI Gameball publishes is v4.0. Alongside it are server SDKs for Node.js, Python, PHP, Ruby and .NET, actively-maintained mobile client SDKs for iOS, Android, Flutter and React Native, an embeddable web widget, signed webhooks, asynchronous batch ingestion, a test/live dual-key sandbox, an official OAuth-gated remote MCP server at https://mcp.gameball.co exposing 54 dashboard tools, a published A2A agent card and a provider-authored Agent Skill. Gameball is trusted by 3,000+ brands across 70+ countries and is a 500 Global portfolio company.

Gameball publishes 8 APIs on the APIs.io network, including Batches API, Customers API, Events API, and 5 more. Tagged areas include Company, Loyalty, Rewards, Gamification, and Customer Engagement.

The Gameball catalog on APIs.io includes 1 event-driven AsyncAPI specification.

Gameball’s developer surface includes documentation, API reference, getting-started guide, support, engineering blog, pricing, signup flow, and 36 more developer resources.

🌐 Visit website 📡 Source on GitHub

58.4/100 strong ▬ flat Agent 42/100 agent native Full breakdown ↓
scored 2026-09-06 · rubric v0.19.0

AccessSelf serve

1 APIs 2 MCP Servers

Company Loyalty Rewards Gamification Customer Engagement Retention Referrals Marketing E-Commerce

Kin Score

Kin Score How this is scored →
scored 2026-09-06 · rubric v0.19.0

Composite quality — 58.4/100 · strong

Contract Quality 14.4 / 25

Developer Ergonomics 15.7 / 20

Access Clarity 10.5 / 20

Operational Transparency 9.6 / 13

Contract Governance 0.5 / 12

Discoverability 7.6 / 10

Agent readiness — 42/100 · agent native

Machine-Readable Contract 18 / 18

Agentic Access Contract 0 / 10

Documented Reversibility 6 / 6

MCP Server 12 / 12

Machine-Readable Auth 10 / 10

Idempotency 9 / 9

Stable Error Semantics 8 / 8

Request/Response Examples 7 / 7

Rate-Limit Signaling 7 / 7

Typed Event Surface 6 / 6

Agent Skills 5 / 5

Well-Known Catalog 0 / 4

Consent & Bot Identity 0 / 3

A2A Agent Card 0 / 8

Dry-Run / Simulate Mode 0 / 4

Delegated User Identity 0 / 6

Protected Resource Metadata 0 / 5

Registration Without a Human 0 / 6

Agentic Commerce Well-Known Document 0 / 5

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. Every facet and dimension name above is a link: it opens that measurement's own page — what it means, the exact checks that feed it, how the whole catalog distributes on it, and the providers at the top of it. This rating is computed from github.com/api-evangelist/gameball: open an issue to ask a question, or submit a pull request to add artifacts. Submit an artifact on GitHub — free → Manage your own listing — the Influence plan, $499/mo →

APIs 9

Individual APIs this provider publishes, each with its own machine-readable definition.

MCP Servers 2

Model Context Protocol servers that expose these APIs to AI agents.

Rate Limits 1

Documented rate limits and quota policies.

Scopes 1

OAuth scopes governing access to this provider's APIs.

Gameball Scopes

OAuth 2.0 · no documented scopes

0 scopes

SCOPES

Resources

Get Started 4

Portal, sign-up, and the first successful call

DeveloperPortal

GettingStarted

SignUp

Sandbox

Documentation 3

Reference material describing how the API behaves

Documentation

Documentation

APIReference

APIReference

OpenAPI

OpenAPI

Agent Surfaces 6

MCP servers, agent skills, and machine-readable catalogs

MCPServer

LLMsTxt

AgentSkill

WellKnown

MCPServer

LLMsTxt

Design & Contract 9

Pagination, idempotency, versioning, errors, and events

ErrorCatalog

Conventions

Idempotency

Lifecycle

Webhooks

Components

Conformance

DataModel

ErrorCatalog

Scroll for all 9

Build 4

SDKs, sample code, and the tooling you integrate with

GitHubOrganization

Packages

SDKs

ToolCrosswalk

Access & Security 3

Authentication, authorization, and security posture

Authentication

Authentication

DomainSecurity

DomainSecurity

OAuthScopes

OAuthScopes

Operate 6

Status, limits, changes, and where to get help

Support

RateLimits

ChangeLog

StatusPage

ChangeLog

HelpCenter

Commercial 4

Pricing, plans, and the legal terms of use

Pricing

TermsOfService

PrivacyPolicy

Plans

Company 2

The organization behind the API

Website

Website

Blog

Blog

Other 2

Properties that don't map to a standard resource type

Overlay

Overlay

AgentCard

AgentCard

Source (apis.yml)

aid: gameball
name: Gameball
description: Gameball is a customer loyalty and gamification platform that helps consumer brands turn one-time buyers into
  repeat customers through points, VIP tiers, referrals, cashback, coupons, reward campaigns and gamified experiences (spin
  the wheel, scratch & win, missions, stamps) plus email/SMS/push communication and automation campaigns. It exposes a RESTful
  API (base https://api.gameball.co/api/{version}) secured with APIKey and SecretKey headers — v4.1 "Secure Integration Mode"
  is the documented current release, though the only OpenAPI Gameball publishes is v4.0. Alongside it are server SDKs for
  Node.js, Python, PHP, Ruby and .NET, actively-maintained mobile client SDKs for iOS, Android, Flutter and React Native,
  an embeddable web widget, signed webhooks, asynchronous batch ingestion, a test/live dual-key sandbox, an official OAuth-gated
  remote MCP server at https://mcp.gameball.co exposing 54 dashboard tools, a published A2A agent card and a provider-authored
  Agent Skill. Gameball is trusted by 3,000+ brands across 70+ countries and is a 500 Global portfolio company.
url: https://raw.githubusercontent.com/api-evangelist/gameball/refs/heads/main/apis.yml
x-type: company
x-source: vc-portfolio
x-backed-by:
- 500-global
x-tier: stub
x-tier-reason: portfolio-lead
deliveryModel:
  model: unknown
  open_source: unknown
  commercial: true
  callable_host: true
  label: Delivery model not determined — needs a product licence on record
  confidence: low
  source:
  - openapi
  - pricing
  - repository-unlicensed
  generated: '2026-08-28'
  method: derived
accessModel:
  pricing: unknown
  onboarding: self-serve
  trial: false
  try_now: false
  public: false
  label: Self-serve signup
  confidence: medium
  source:
  - authentication
  generated: '2026-07-22'
  method: derived
specificationVersion: '0.23'
created: '2026-07-17'
modified: '2026-08-13'
image: https://cdn.prod.website-files.com/6908b0d43805904c24a1139a/6909d1a17d9fb50ab471f71f_logo.svg
tags:
- Company
- Loyalty
- Rewards
- Gamification
- Customer Engagement
- Retention
- Referrals
- Marketing
- E-Commerce
tags_raw:
- Company
- Loyalty
- Rewards
- Gamification
- Customer Engagement
- Retention
- Referrals
- Marketing
- E-commerce
apis:
- name: Gameball MCP Server
  description: Official remote Model Context Protocol server exposing 54 tools over the Gameball merchant/dashboard surface
    — customer lookup and points adjustment, tag management, earning configuration and custom earning rules, redemption options,
    reward-campaign authoring (event, date, calendar, game, mission), tier and program state, widget settings and localization,
    and analytics. OAuth 2.0 with PKCE and dynamic client registration; a single "mcp" scope covers the whole surface.
  humanURL: https://github.com/gameballers/gameball-mcp-codex
  baseURL: https://mcp.gameball.co/mcp
  properties:
  - type: MCPServer
    url: mcp/gameball-mcp.yml
  - type: MCPServer
    url: https://mcp.gameball.co/mcp
  - type: ToolCrosswalk
    url: mcp/gameball-tool-crosswalk.yml
  - type: OAuthScopes
    url: scopes/gameball-scopes.yml
  - type: Authentication
    url: authentication/gameball-authentication.yml
  - type: SourceCode
    url: https://github.com/gameballers/gameball-mcp-codex
- aid: gameball:gameball-batches-api
  name: Gameball Batches API
  description: The Batches API from Gameball — 1 operation(s) for batches.
  humanURL: https://docs.gameball.co/api-reference/introduction
  baseURL: https://api.gameball.co/api/v4.0
  tags:
  - Batches
  properties:
  - type: OpenAPI
    url: openapi/gameball-batches-api-openapi.yml
  - type: Documentation
    url: https://docs.gameball.co
  - type: APIReference
    url: https://docs.gameball.co/api-reference/introduction
  - type: Authentication
    url: authentication/gameball-authentication.yml
  - type: RateLimits
    url: rate-limits/gameball-rate-limits.yml
  - type: Webhooks
    url: asyncapi/gameball-webhooks.yml
  - type: ErrorCatalog
    url: errors/gameball-error-codes.yml
  - type: ErrorCatalog
    url: errors/gameball-problem-types.yml
  - type: Sandbox
    url: sandbox/gameball-sandbox.yml
- aid: gameball:gameball-customers-api
  name: Gameball Customers API
  description: The Customers API from Gameball — 1 operation(s) for customers.
  humanURL: https://docs.gameball.co/api-reference/introduction
  baseURL: https://api.gameball.co/api/v4.0
  tags:
  - Customers
  properties:
  - type: OpenAPI
    url: openapi/gameball-customers-api-openapi.yml
  - type: Documentation
    url: https://docs.gameball.co
  - type: APIReference
    url: https://docs.gameball.co/api-reference/introduction
  - type: Authentication
    url: authentication/gameball-authentication.yml
  - type: RateLimits
    url: rate-limits/gameball-rate-limits.yml
  - type: Webhooks
    url: asyncapi/gameball-webhooks.yml
  - type: ErrorCatalog
    url: errors/gameball-error-codes.yml
  - type: ErrorCatalog
    url: errors/gameball-problem-types.yml
  - type: Sandbox
    url: sandbox/gameball-sandbox.yml
- aid: gameball:gameball-events-api
  name: Gameball Events API
  description: The Events API from Gameball — 1 operation(s) for events.
  humanURL: https://docs.gameball.co/api-reference/introduction
  baseURL: https://api.gameball.co/api/v4.0
  tags:
  - Event
  tags_raw:
  - Events
  properties:
  - type: OpenAPI
    url: openapi/gameball-events-api-openapi.yml
  - type: Documentation
    url: https://docs.gameball.co
  - type: APIReference
    url: https://docs.gameball.co/api-reference/introduction
  - type: Authentication
    url: authentication/gameball-authentication.yml
  - type: RateLimits
    url: rate-limits/gameball-rate-limits.yml
  - type: Webhooks
    url: asyncapi/gameball-webhooks.yml
  - type: ErrorCatalog
    url: errors/gameball-error-codes.yml
  - type: ErrorCatalog
    url: errors/gameball-problem-types.yml
  - type: Sandbox
    url: sandbox/gameball-sandbox.yml
- aid: gameball:gameball-gameball-api-api
  name: Gameball Gameball API
  description: The Gameball API API from Gameball — 0 operation(s) for gameball api.
  humanURL: https://docs.gameball.co/api-reference/introduction
  baseURL: https://api.gameball.co/api/v4.0
  tags:
  - Gameball API
  properties:
  - type: OpenAPI
    url: openapi/gameball-gameball-api-api-openapi.yml
  - type: Documentation
    url: https://docs.gameball.co
  - type: APIReference
    url: https://docs.gameball.co/api-reference/introduction
  - type: Authentication
    url: authentication/gameball-authentication.yml
  - type: RateLimits
    url: rate-limits/gameball-rate-limits.yml
  - type: Webhooks
    url: asyncapi/gameball-webhooks.yml
  - type: ErrorCatalog
    url: errors/gameball-error-codes.yml
  - type: ErrorCatalog
    url: errors/gameball-problem-types.yml
  - type: Sandbox
    url: sandbox/gameball-sandbox.yml
- aid: gameball:gameball-integrations-api
  name: Gameball Integrations API
  description: The Integrations API from Gameball — 62 operation(s) for integrations.
  humanURL: https://docs.gameball.co/api-reference/introduction
  baseURL: https://api.gameball.co/api/v4.0
  tags:
  - Integration
  tags_raw:
  - Integrations
  properties:
  - type: OpenAPI
    url: openapi/gameball-integrations-api-openapi.yml
  - type: Documentation
    url: https://docs.gameball.co
  - type: APIReference
    url: https://docs.gameball.co/api-reference/introduction
  - type: Authentication
    url: authentication/gameball-authentication.yml
  - type: RateLimits
    url: rate-limits/gameball-rate-limits.yml
  - type: Webhooks
    url: asyncapi/gameball-webhooks.yml
  - type: ErrorCatalog
    url: errors/gameball-error-codes.yml
  - type: ErrorCatalog
    url: errors/gameball-problem-types.yml
  - type: Sandbox
    url: sandbox/gameball-sandbox.yml
- aid: gameball:gameball-orders-api
  name: Gameball Orders API
  description: The Orders API from Gameball — 4 operation(s) for orders.
  humanURL: https://docs.gameball.co/api-reference/introduction
  baseURL: https://api.gameball.co/api/v4.0
  tags:
  - Order
  tags_raw:
  - Orders
  properties:
  - type: OpenAPI
    url: openapi/gameball-orders-api-openapi.yml
  - type: Documentation
    url: https://docs.gameball.co
  - type: APIReference
    url: https://docs.gameball.co/api-reference/introduction
  - type: Authentication
    url: authentication/gameball-authentication.yml
  - type: RateLimits
    url: rate-limits/gameball-rate-limits.yml
  - type: Webhooks
    url: asyncapi/gameball-webhooks.yml
  - type: ErrorCatalog
    url: errors/gameball-error-codes.yml
  - type: ErrorCatalog
    url: errors/gameball-problem-types.yml
  - type: Sandbox
    url: sandbox/gameball-sandbox.yml
- aid: gameball:gameball-payments-api
  name: Gameball Payments API
  description: The Payments API from Gameball — 1 operation(s) for payments.
  humanURL: https://docs.gameball.co/api-reference/introduction
  baseURL: https://api.gameball.co/api/v4.0
  tags:
  - Payments
  properties:
  - type: OpenAPI
    url: openapi/gameball-payments-api-openapi.yml
  - type: Documentation
    url: https://docs.gameball.co
  - type: APIReference
    url: https://docs.gameball.co/api-reference/introduction
  - type: Authentication
    url: authentication/gameball-authentication.yml
  - type: RateLimits
    url: rate-limits/gameball-rate-limits.yml
  - type: Webhooks
    url: asyncapi/gameball-webhooks.yml
  - type: ErrorCatalog
    url: errors/gameball-error-codes.yml
  - type: ErrorCatalog
    url: errors/gameball-problem-types.yml
  - type: Sandbox
    url: sandbox/gameball-sandbox.yml
- aid: gameball:gameball-plants-api
  name: Gameball Plants API
  description: The Plants API from Gameball — 2 operation(s) for plants.
  humanURL: https://docs.gameball.co/api-reference/introduction
  baseURL: https://api.gameball.co/api/v4.0
  tags:
  - Plants
  properties:
  - type: OpenAPI
    url: openapi/gameball-plants-api-openapi.yml
  - type: Documentation
    url: https://docs.gameball.co
  - type: APIReference
    url: https://docs.gameball.co/api-reference/introduction
  - type: Authentication
    url: authentication/gameball-authentication.yml
  - type: RateLimits
    url: rate-limits/gameball-rate-limits.yml
  - type: Webhooks
    url: asyncapi/gameball-webhooks.yml
  - type: ErrorCatalog
    url: errors/gameball-error-codes.yml
  - type: ErrorCatalog
    url: errors/gameball-problem-types.yml
  - type: Sandbox
    url: sandbox/gameball-sandbox.yml
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
common:
- type: Website
  url: https://gameball.co
- type: DeveloperPortal
  url: https://developer.gameball.co
- type: Documentation
  url: https://docs.gameball.co
- type: APIReference
  url: https://docs.gameball.co/api-reference/introduction
- type: GettingStarted
  url: https://docs.gameball.co/product-documentation/getting-started/launch-checklist
- type: Support
  url: https://docs.gameball.co/
- type: Blog
  url: https://www.gameball.co/blog
- type: GitHubOrganization
  url: https://github.com/gameballers
- type: Pricing
  url: https://www.gameball.co/pricing
- type: SignUp
  url: https://app.gameball.co/login
- type: TermsOfService
  url: https://www.gameball.co/terms-and-conditions
- type: PrivacyPolicy
  url: https://www.gameball.co/privacy-policy
- type: Authentication
  url: authentication/gameball-authentication.yml
- type: Packages
  url: packages/gameball-packages.yml
- type: SDKs
  url: packages/gameball-packages.yml
- type: MCPServer
  url: mcp/gameball-mcp.yml
- type: LLMsTxt
  url: llms/gameball-llms.txt
- type: ErrorCatalog
  url: errors/gameball-error-codes.yml
- type: Conventions
  url: conventions/gameball-conventions.yml
- type: Idempotency
  url: conventions/gameball-conventions.yml
- type: RateLimits
  url: rate-limits/gameball-rate-limits.yml
- type: Lifecycle
  url: lifecycle/gameball-lifecycle.yml
- type: ChangeLog
  url: changelog/gameball-changelog.yml
- type: Webhooks
  url: asyncapi/gameball-webhooks.yml
- type: Components
  url: components/gameball-components.yml
- type: Conformance
  url: conformance/gameball-conformance.yml
- type: DataModel
  url: data-model/gameball-data-model.yml
- type: DomainSecurity
  url: security/gameball-domain-security.yml
- type: OpenAPI
  url: openapi/gameball-openapi.json
- type: Overlay
  url: overlays/gameball-openapi-overlay.yaml
- type: AgentCard
  url: a2a/gameball-a2a.yml
- type: AgentSkill
  url: skills/_index.yml
- type: WellKnown
  url: well-known/gameball-well-known.yml
- type: MCPServer
  url: https://mcp.gameball.co/mcp
- type: ToolCrosswalk
  url: mcp/gameball-tool-crosswalk.yml
- type: OAuthScopes
  url: scopes/gameball-scopes.yml
- type: Plans
  url: plans/gameball-plans-pricing.yml
- type: Sandbox
  url: sandbox/gameball-sandbox.yml
- type: ErrorCatalog
  url: errors/gameball-problem-types.yml
- type: StatusPage
  url: https://gameball.statuspage.io
- type: LLMsTxt
  url: https://docs.gameball.co/llms.txt
- type: ChangeLog
  url: https://docs.gameball.co/changelog/updates
- type: HelpCenter
  url: https://help.gameball.co
x-enrichment:
  date: '2026-08-13'
  status: enriched
  artifacts_added: 19
  pass: local-v1

Work with this as data

Every provider here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for providers

9 MCP tools reach this

find_providersBrowse and filter every provider in the catalog.
get_provider_artifactsEvery artifact this provider publishes, grouped by type.
get_provider_operationsEvery operation across all of their OpenAPIs — one call instead of parsing every spec.
get_provider_toolsEvery MCP tool they ship, with the operation each wraps.
get_provider_evidenceHow each part of their score was established. Free — the basis for a claim should not sit behind it.
get_provider_ratingPRO — composite, band, trend and facet scores.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This provider

curl "https://apis.io/api/v1/providers/gameball"

All providers

curl "https://apis.io/api/v1/providers?limit=25"

Every operation they expose

curl "https://apis.io/api/v1/providers/gameball/operations?limit=25"

How their score was established

curl "https://apis.io/api/v1/providers/gameball/evidence"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.