Dashboard API
Billing Overview
Check your balance, view billing entries, and monitor usage.
PacSpace uses a credit-based billing system. Credits are consumed when your data completes verification. Use these endpoints to check your balance and review transaction history.
All routes require a valid JWT in the Authorization header:
-H "Authorization: Bearer YOUR_JWT_TOKEN"
Base URL: https://balance-api.pacspace.io
Get Balance
Retrieve your current credit balance, including reserved amounts.
curl https://balance-api.pacspace.io/dashboard/credit/balances \
-H "Authorization: Bearer YOUR_JWT_TOKEN"
Response 200 OK
{
"statusCode": 200,
"data": {
"creditBalance": 95000,
"availableBalance": 94200,
"reserved": 800
}
}
Balance Fields
| Field | Description |
|---|---|
creditBalance | Total credits in your account |
availableBalance | Credits available to spend (creditBalance minus reserved) |
reserved | Credits temporarily held for in-progress verifications |
How reservation works: When you submit data, credits are reserved upfront. Once verification completes, the actual cost is settled — any excess reservation is released back to your available balance.
Get Billing Entries
View your transaction history — credits added, consumed, and reserved.
curl "https://balance-api.pacspace.io/dashboard/credit/entries?page=1&limit=20" \
-H "Authorization: Bearer YOUR_JWT_TOKEN"
Response 200 OK
{
"statusCode": 200,
"data": {
"items": [
{
"id": "entry_001",
"type": "settlement",
"amount": -150,
"description": "Verification batch settled — 150 deltas",
"balanceAfter": 94850,
"createdAt": "2025-06-10T14:30:00.000Z"
},
{
"id": "entry_002",
"type": "reservation",
"amount": -800,
"description": "Credits reserved for pending verifications",
"balanceAfter": 94200,
"createdAt": "2025-06-10T14:25:00.000Z"
},
{
"id": "entry_003",
"type": "topup",
"amount": 10000,
"description": "Manual credit top-up",
"balanceAfter": 95000,
"createdAt": "2025-06-09T10:00:00.000Z"
}
],
"total": 47,
"page": 1,
"limit": 20
}
}
Entry Types
| Type | Description |
|---|---|
topup | Credits added to your account |
reservation | Credits reserved for pending verifications |
settlement | Final charge after verification completes |
release | Reserved credits returned (overage from estimation) |
refund | Credits returned due to failed verification |
Understanding Credit Flow
Here's how credits move through the system:
- Top up — Add credits to your account (via dashboard or sales)
- Reserve — When you submit data, estimated credits are held
- Settle — Once verification completes, actual costs are charged
- Release — If the estimate was higher than actual cost, the difference is released
Available Balance = Credit Balance - Reserved
Monitoring Usage
To keep track of your credit consumption in real time, set up a webhook for verification.completed events. Each event payload includes the credits consumed:
{
"event": "verification.completed",
"data": {
"creditsConsumed": 12,
"remainingBalance": 94838
}
}
You can also check your balance anytime in the PacSpace Dashboard.
Endpoints Summary
| Endpoint | Method | Description |
|---|---|---|
/dashboard/credit/balances | GET | Current credit balance |
/dashboard/credit/entries | GET | Transaction history (paginated) |
Last updated February 11, 2026