Skip to main content

​
Viewing your balance

Navigate to Credits in the sidebar. The page heading shows the current balance in this format: 
Credits : $12.480
The same balance is also shown on the billing page in the Credit balance card.

​
Credit packs

Navigate to Billing in the sidebar. The Credit packs section shows six pack buttons:
Button
$10
$25
$50
$100
$500
$1000
Selecting a pack opens the embedded checkout flow for that product.

​
Requirements

Credit pack purchases require:
RequirementDetail
Active subscriptionYou must have an active Starter, Pro, Scale, or Enterprise plan
PermissionOnly the Primary Owner can purchase
If there is no active subscription, the pack buttons are disabled and the message reads “Subscribe to a plan first to purchase credit packs”. If the viewer is an Owner or Member, the message reads “Only the team creator can purchase credit packs”.

​
Checking balance via API

Use the billing endpoint to check your credit balance programmatically:
Terminal
curl https://api.us.babysea.ai/v1/user/billing \
  -H "Authorization: Bearer bye_your_api_key"
The response includes your current balance:
JSON
{
  "status": "success",
  "request_id": "req_a1b2c3d4",
  "message": "User billing data retrieved successfully",
  "timestamp": "2026-03-06T12:30:45.000Z",
  "data": {
    "account_id": "acc_123",
    "billing_plan": "Starter Monthly",
    "billing_credit_balance": 12.480
  }
}
Your API key must have the account:read scope. See Scopes for details.

​
With the SDK

TypeScript
import { BabySea } from 'babysea';

const client = new BabySea({
  apiKey: process.env.BABYSEA_API_KEY,
  region: 'us',
});

const billing = await client.billing();
console.log(billing.data.billing_credit_balance);

​
How credits are added

The credit ledger records additions as add entries. In the dashboard, the description formatter turns known internal descriptions into user-facing labels.
Raw ledger descriptionDashboard label
Welcome credits - user:<id>Welcome credits
invoice:<id>Subscription renewal
order:<id>Credit pack purchase
Subscription invoice <id>Subscription renewal
Other valuesUnchanged
The credit system enforces idempotency for add entries so duplicate billing events do not double-credit the account.

​
Welcome credits

Every new BabySea account receives $1.000 in welcome credits automatically. Welcome credits are granted once per user. Creating additional team accounts does not grant additional welcome credits.

​
Permissions

ActionPrimary OwnerOwnerMember
View balanceYesYesYes
View transactionsYesYesYes
Purchase credit packsYesNoNo