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,
    "billing_subscription_status": "active",
    "billing_cancel_at_period_end": false,
    "billing_currency": "USD",
    "billing_period_starts_at": "2026-03-01T00:00:00.000Z",
    "billing_period_ends_at": "2026-04-01T00:00:00.000Z",
    "billing_created_at": "2026-03-01T00:00:00.000Z",
    "billing_updated_at": "2026-03-01T00:00:00.000Z"
  }
}
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, BabySea normalizes billing-related descriptions into user-facing labels.
Credit sourceDashboard label
Welcome credit grantWelcome credits
Subscription billingSubscription renewal
Credit pack purchaseCredit pack purchase
Other balance changesContext-specific label
BabySea applies billing safeguards so balance updates are not duplicated by repeated payment events.

​
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

​
Next steps

  • Overview - How credits work and where they come from
  • Transactions - Read and search your credit ledger
  • Usage - Preview costs before generating