API Documentation

REST API reference for the GetSmart Token platform.

The GetSmart Token REST API allows developers to integrate badge issuance, $GETS token management, and learner data into external applications.

Base URL

https://api.getstoken.org/v1

All requests must use HTTPS.

Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

To obtain an API key, contact hello@getstoken.org.

Limit	Value
Per hour	1,000 requests per API key
Per second	10 requests per API key

Exceeded limits return 429 Too Many Requests.

Resource	Operations
Users	Create, retrieve, update learner profiles
Badges	Issue, verify, list badges
Tokens	Check $GETS balances, view token history
Achievements	Track mission progress and completion status

Full endpoint reference available at api.getstoken.org/v1/docs.

All responses are JSON:

{
  "status": "success",
  "data": { }
}

Errors:

{
  "status": "error",
  "error": {
    "code": "ERROR_CODE",
    "message": "Description of the error"
  }
}

Layer	Technology
Frontend	Next.js 15 (App Router) on Cloudflare Pages
AI Agent	Google Gemma 4 via Gemini API + on-device LiteRT/WebGPU
Chatbot	Cloudflare Worker
Blockchain	Base network (Coinbase)
Auth	Coinbase OAuth
Database	MongoDB Atlas

Repo	Description
getsmart-web	Next.js 15 main site
gemma_airgap	Gemma AirGap Agent (standalone)
gs_help_int	This help documentation

For API access, integration questions, or to report issues:

Was this page helpful?

Sorry to hear that. Please tell us how we can improve.