REST v1.0

MicroSplit AI API Reference

All API endpoints accept and return JSON payloads. Rate limits are applied per client IP using sliding windows.

POST/api/split-runs

Executes a zero-loss attribution calculation across squad members and queues the split run for approval.

{
  "squadId": "sqd_1",
  "poolMinor": 100000,
  "currency": "USD",
  "ruleConfig": {
    "consistency_percent": 5,
    "streak_cap_days": 100
  },
  "memberSplits": [
    { "memberId": "mem_1", "percentage": 40, "streakDays": 45 },
    { "memberId": "mem_2", "percentage": 30, "streakDays": 12 },
    { "memberId": "mem_3", "percentage": 30, "streakDays": 0 }
  ]
}

GET/api/squads

Returns all active squads, member counts, total settlements, and base currency.

POST/api/split-runs/{id}/payout

Submits one persisted, approved USD split to PayPal Sandbox. Only squad owners and approvers can submit; each member must explicitly confirm a valid PayPal email first. A unique payout claim is retained if provider confirmation is uncertain.

Never use this endpoint for live funds. Submission is Sandbox-only and is protected against duplicate claims.

GET/api/payouts

Returns persisted payout batches for squads where the signed-in user is an owner or approver. Recipient emails are masked.

POST/api/payouts/{id}/reconcile

Explicitly retrieves and persists the current PayPal Sandbox batch and item statuses for an authorized squad reviewer.

POST/api/contact

Submits a support inquiry ticket. Sanitized against XSS and rate limited to 5 requests per 5 minutes.