Thrive API

Account

Learning progress, credit usage and connected-app status.

Get learning progress

GET /v1/progress

How many lessons and simulations the key owner has started and completed.

Authentication: API key · Required scope: progress:read

curl "https://jointhrive.org/api/public/v1/progress" \
  -H "Authorization: Bearer $THRIVE_API_KEY"

Response · 200

{
  "object": "progress",
  "lessons": { "started": 12, "completed": 9 },
  "simulations": { "started": 4, "completed": 3 }
}

Errors: missing_scope

Try it

GET /v1/usage

Agent credit balance and the 20 most recent credit changes. Read-only: credits, billing and plans can't be changed through the API.

Authentication: API key · Required scope: usage:read

curl "https://jointhrive.org/api/public/v1/usage" \
  -H "Authorization: Bearer $THRIVE_API_KEY"

Response · 200

{
  "object": "usage",
  "balance": 84,
  "plan_id": "credits_100",
  "recent": [ { "amount": -1, "type": "usage", "source": "developer_api" } ]
}

Errors: missing_scope

Try it

GET /v1/connections

Which outside apps (Gmail, Plaid, …) the owner has connected, and their status. Data from those apps is never available through the API or MCP.

Authentication: API key · Required scope: connections:read

curl "https://jointhrive.org/api/public/v1/connections" \
  -H "Authorization: Bearer $THRIVE_API_KEY"

Response · 200

{
  "object": "list",
  "data": [ { "provider": "gmail", "status": "connected" } ]
}

Errors: missing_scope

Try it