🤖 Family Bank Pro Feature

AI Banker & Grokbot API Integration

Generate your personal Bearer API Token below to connect Grokbot, ChatGPT, Claude, or Apple Siri Shortcuts to your family bank.

← Back to Parent Dashboard

🔑Your Personal Allowance Bot Token

Each token is scoped strictly to the children you own (your kids) and stored as a one-way SHA-256 hash.

Sign In to Generate Token →

Ready-to-Use Grokbot / AI Agent Prompt

Automatically customized with your children's slugs (elon | corwin | judah) and the /api/allowance/summary endpoint!

You are connected to the TrackAllowance Family Bank API at https://www.trackallowance.com.
Always authenticate with header: Authorization: Bearer <YOUR_ALLOWANCE_BOT_TOKEN>

Allowed child slugs for this family: elon | corwin | judah

Available Endpoints:
1. GET /api/allowance/summary
   Optional query: ?child=judah
   Returns each child's total balance, spendableBalance (Checking), savedInSubAccounts, weeklyAllowance, interestRateMonthly, and active subAccounts (savings jars & goals).

2. POST /api/allowance/entries
   Headers:
     Content-Type: application/json
     Idempotency-Key: <unique 16-128 char key>
   Body:
     {
       "child": "judah",
       "type": "debit" | "credit",
       "amount": "12.50",
       "description": "Bought LEGO set",
       "date": "YYYY-MM-DD"
     }

3. GET /api/allowance/history?child=judah&start=YYYY-MM-DD&end=YYYY-MM-DD&type=all|debit|credit&limit=25
   Returns paginated ledger entries for the date window.

4. GET /api/allowance/health
   Verifies token authentication and returns your allowed child slugs.
POST/api/allowance/entries

Idempotently record a credit or debit transaction for a child and update their total balance in a single atomic Firestore transaction.

curl -X POST https://www.trackallowance.com/api/allowance/entries \
  -H "Authorization: Bearer <YOUR_ALLOWANCE_BOT_TOKEN>" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: bot-2026-11-08-0001" \
  -d '{
    "child": "judah",
    "type": "debit",
    "amount": "8.50",
    "description": "Ice cream shop",
    "date": "2026-11-08"
  }'
GET/api/allowance/summaryNEW

Fetch each child's Total Balance, Available Checking (Spendable Balance), Saved in Sub-Accounts, Weekly Allowance, and active Sub-Account Jars/Goals.

curl "https://www.trackallowance.com/api/allowance/summary?child=judah" \
  -H "Authorization: Bearer <YOUR_ALLOWANCE_BOT_TOKEN>"
GET/api/allowance/history

Read-only date-range ledger history with cursor pagination and optional type=debit|credit|all filter.

curl "https://www.trackallowance.com/api/allowance/history?child=judah&start=2026-10-01&end=2026-11-08" \
  -H "Authorization: Bearer <YOUR_ALLOWANCE_BOT_TOKEN>"
GET/api/allowance/health

Verify Bearer token authentication, Firebase project binding, and allowed children scope without reading ledger rows.

curl https://www.trackallowance.com/api/allowance/health \
  -H "Authorization: Bearer <YOUR_ALLOWANCE_BOT_TOKEN>"