Account & Usage

Read-only endpoints for chargeback, billing reconciliation, and monitoring your partner account.

GET/v1/account

Your partner profile, tier, and current credits balance.

curl -H "Authorization: Bearer sk_live_..." https://app.bigmind.com/api/partner/v1/account

GET/v1/account/credits/history

Paginated credit usage log — every charge, refund, and adjustment.

curl -H "Authorization: Bearer sk_live_..." \
  "https://app.bigmind.com/api/partner/v1/account/credits/history?page=1&limit=50"

Negative creditsUsed values represent refunds (e.g., customer deletions, plan downgrades).

GET/v1/customers/{id}/usage

Storage used and device/file counts for a single customer.

curl -H "Authorization: Bearer sk_live_..." \
  https://app.bigmind.com/api/partner/v1/customers/pc_42_.../usage

GET/v1/usage/summary

Partner-wide rollup. Optional from/to date range filters credit-usage events.

curl -H "Authorization: Bearer sk_live_..." \
  "https://app.bigmind.com/api/partner/v1/usage/summary?from=2026-05-01T00:00:00Z&to=2026-05-31T23:59:59Z"

Date params accept ISO 8601 timestamps. Both are optional — omit to get all-time totals.