@flowcheck/sdk

@flowcheck/sdk

TypeScript SDK for the FlowCheck API — unified access to Stripe revenue and bank transaction data.

Install

npm install @flowcheck/sdk

Quick start

import { FlowCheck } from "@flowcheck/sdk";

const fc = new FlowCheck("fc_live_...");
const { data } = await fc.cashflow("30d");

console.log(`Net: $${data.net / 100}`);

curl equivalent

curl https://developer.usepopup.com/api/v0/cashflow?window=30d \
  -H "Authorization: Bearer fc_live_..."

Example response

{
  "data": {
    "window": "30d",
    "total_inflow": 523400,
    "total_outflow": 187600,
    "net": 335800,
    "daily": [
      { "date": "2026-03-05", "inflow": 18200, "outflow": 4300, "net": 13900 },
      { "date": "2026-03-04", "inflow": 22100, "outflow": 6800, "net": 15300 }
    ]
  },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2026-03-05T10:00:00Z",
    "version": "v0"
  },
  "errors": []
}

All amounts are in cents (USD).

Methods

Method	HTTP	Description
register(email)	POST /auth/register	Create account (no key needed)
registrationStatus(token)	GET /auth/register/status	Check registration / get API key
balance()	GET /balance	Stripe + bank balances
cashflow(window?)	GET /cashflow	Revenue, expenses, net by day
payouts(params?)	GET /payouts	Stripe payouts with match status
payout(id)	GET /payouts/:id	Single payout with bank match
transactions(params?)	GET /transactions	Bank transactions from Plaid
discrepancies(params?)	GET /discrepancies	Missing or mismatched amounts
reconciliationSummary()	GET /reconcile/summary	30-day financial health score
reconciliation(payoutId)	GET /reconcile/:id	Per-payout reconciliation detail
agentPosition()	GET /agent/position	Full financial snapshot for AI agents
agentAlerts()	GET /agent/alerts	Active issues for AI agents
connectStripe(restrictedKey)	POST /connect/stripe	Connect Stripe account
createPlaidLinkToken()	POST /connect/plaid/link-token	Start Plaid bank connection
exchangePlaidToken(publicToken)	POST /connect/plaid/exchange	Complete Plaid connection
webhooks()	GET /webhooks	List webhook endpoints
createWebhook(url, events)	POST /webhooks	Register webhook endpoint
deleteWebhook(id)	DELETE /webhooks/:id	Remove webhook endpoint

Pagination

List endpoints (payouts, transactions, discrepancies) support cursor-based pagination:

const first = await fc.payouts({ limit: 10 });
console.log(first.data); // first 10 payouts

if (first.meta.has_more) {
  const next = await fc.payouts({ limit: 10, cursor: first.meta.cursor });
  console.log(next.data); // next 10 payouts
}

Error handling

The SDK throws on non-2xx responses. The error includes status and body:

try {
  await fc.balance();
} catch (err) {
  if (err.status === 401) {
    console.log("Invalid API key");
  }
  console.log(err.body); // full error response
}

License

MIT