StarSling
APIBill

List prior invoices

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.

View Markdown
GET/api/bill/history

Authorization

bearerAuth
AuthorizationBearer <token>

Session token from sling login.

In: header

Query Parameters

org*string

GitHub organization login whose invoices to list.

Length1 <= length
limit?|

Invoices per page, newest first.

Range1 <= value <= 100
after?string

Invoice id from a prior page — returns the ones after it.

Length1 <= length

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/bill/history?org=acme"
{  "invoices": [    {      "invoice_id": "in_1ToVfTFSjWlUgKNB",      "period": {        "from": "2026-06-12T00:00:00.000Z",        "to": "2026-07-12T00:00:00.000Z"      },      "status": "paid",      "period_source": "stripe",      "runner_minutes": 5820,      "amount_usd": 93.12,      "credits_usd": 0,      "amount_due_usd": 93.12,      "line_items": [        {          "label": "starsling-ubuntu-24.04-8",          "minutes": 5820,          "usd": 93.12        }      ],      "projected_month_end_usd": 93.12    }  ],  "has_more": false}

Billing snapshot for a period GET

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.

Resolve an id or URL to a target POST

Polymorphic ID resolution: given a parsed descriptor (run/job/attempt id, a runner id, a bare id, or a GitHub Actions URL), resolve it against the CI facts store to the most specific target, or return a candidate list on ambiguity. A runner id resolves to the job/attempt target(s) that ran on that runner — or, with target=run, to the distinct run(s) it touched; several candidates when a runner is reused. Authenticated; scoped to the caller's orgs by membership.