API Reference
API Reference
Insights
GETRequires a Bearer token/api/ext/v1/insights/cash-position
Get cash position
Responses
200Cash on hand, estimated monthly burn, and runway — BOB's computed numbers for your organization's account. Amounts in integer cents. Runway appears only when there is enough history to estimate honestly (`sufficient`); status is `not_open` when no BOB account exists yet.
| Field | Type | Description |
|---|---|---|
| as_ofrequired | string · date-time | When these figures were computed (RFC 3339). |
| cash_centsrequired | int64 | Cash on hand, in integer cents (USD). |
| is_burningrequired | boolean | Whether net cash flow is negative over the estimation window. |
| monthly_burn_centsrequired | int64 | Estimated monthly net burn in cents; 0 when not burning. |
| org_idrequired | string | Your organization id. |
| runway_cash_centsoptional | int64 | Conservative cash numerator used for runway math, in integer cents (USD); null when no source-aligned history and cash basis exists. |
| runway_monthsoptional | number · nullable | Estimated months of runway; present only when burning and the estimate is sufficient. |
| runway_noteoptional | string | Human-readable runway phrase, or why no estimate is given. |
| statusrequired | string | Account status backing these figures: open or not_open. |
| sufficientrequired | boolean | Whether there was enough history and a cash reading to estimate honestly. |
200 example
{
"as_of": "2026-01-15T09:30:00Z",
"cash_cents": 1250000,
"is_burning": true,
"monthly_burn_cents": 300000,
"org_id": "org_9f3k2p",
"runway_cash_cents": 1000000,
"runway_months": 4.2,
"runway_note": "About 4 months of runway at the current burn.",
"status": "open",
"sufficient": true
}Errors
401Missing or invalid API token
403Token lacks the required scope or credential class
429Rate limit exceeded
500Failed to compute the figures — retry later
503Figures temporarily unavailable
All errors return { "error": string }.
Example request
curl https://api.bankofbots.ai/api/ext/v1/insights/cash-position \
-H "Authorization: Bearer $BOB_API_TOKEN"GETRequires a Bearer token/api/ext/v1/receivables/aging
Get receivables aging
Responses
200Who owes your organization money and how overdue: totals, day buckets, and the top overdue customers. Covers ALL receivables — invoices issued through BOB and any imported from connected accounting systems — USD-normalized, in integer cents.
| Field | Type | Description |
|---|---|---|
| as_ofrequired | string · date-time | When these figures were computed (RFC 3339). |
| bucketsrequired | AgingBuckets | |
| org_idrequired | string | Your organization id. |
| top_overduerequired | OverdueEntry[] | Up to five customers with the largest overdue balances. |
| total_open_centsrequired | int64 | All open receivables, in integer cents (USD-normalized). |
| total_overdue_centsrequired | int64 | The past-due portion of open receivables, in cents. |
200 example
{
"as_of": "2026-01-15T09:30:00Z",
"buckets": {
"current_cents": 627000,
"days_1_30_cents": 120000,
"days_31_60_cents": 60000,
"days_61_90_cents": 35000,
"days_90_plus_cents": 0
},
"org_id": "org_9f3k2p",
"top_overdue": [
{
"balance_cents": 150000,
"customer_name": "Acme Corp",
"days_late": 12
}
],
"total_open_cents": 842000,
"total_overdue_cents": 215000
}Errors
401Missing or invalid API token
403Token lacks the required scope or credential class
429Rate limit exceeded
500Failed to compute the figures — retry later
503Figures temporarily unavailable
All errors return { "error": string }.
Example request
curl https://api.bankofbots.ai/api/ext/v1/receivables/aging \
-H "Authorization: Bearer $BOB_API_TOKEN"Was this page helpful?