StarSling
APIBill

Billing snapshot for a period

Read-only budget check. With no month, it returns the current open billing period: runner minutes, cost, credits, amount due, per-label line items, and a projected month-end total. Pass month=YYYY-MM to check a past period — a closed month returns its finalized Stripe invoice, or an in-house estimate when no invoice covers it. Scoped to the caller's orgs. Plan/payment changes stay in the dashboard.

View Markdown
GET/api/bill

Authorization

bearerAuth
AuthorizationBearer <token>

Session token from sling login.

In: header

Query Parameters

org*string

GitHub organization login the bill belongs to.

Length1 <= length
month?string

A finalized month, YYYY-MM. Omit for the current open period.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/bill?org=acme"
{  "period": {    "from": "2026-07-12T00:00:00.000Z",    "to": "2026-08-12T00:00:00.000Z"  },  "status": "open",  "period_source": "install_cycle",  "runner_minutes": 2910,  "amount_usd": 46.56,  "credits_usd": 8,  "amount_due_usd": 38.56,  "free_credit_total_usd": 8,  "free_credit_remaining_usd": 0,  "line_items": [    {      "label": "starsling-ubuntu-24.04-8",      "minutes": 2910,      "usd": 46.56    }  ],  "projected_month_end_usd": 92.4}

Runner minutes and cost by group GET

Runner-minute and cost attribution over a time window, grouped by label/workflow/job/repo/day. Scoped to the caller's orgs.

List prior invoices GET

Read-only list of the caller's prior finalized invoices (newest first), same per-item shape as /api/bill, paginated by count. Scoped to the caller's orgs.