---
title: "Starter Credits"
method: GET
path: "/v1/me/admin/credits"
tags: ["model spend"]
---

# Starter Credits

`GET /v1/me/admin/credits`

Every business the $50 starter credit touches: free, used up, on a card, or exempt.

One row per team with model spend since the credit epoch, a subscription,
or a creation date past the epoch. The numbers are the spend guard's own
(`starter_credit.CreditBook`), so this board and the wall cannot disagree.

## Query parameters

- `limit` integer

## Headers

- `authorization` string, nullable
- `x-darwin-token` string, nullable

## Response `200`

Successful Response

- CreditBoard
  - `granted_usd` number, required
  - `epoch` string, date-time, required
  - `complete` boolean, required
  - `measured_seconds_ago` number, nullable
  - `totals` CreditTotals, required
    - `businesses` integer, required
    - `on_credit` integer, required
    - `used_up` integer, required
    - `with_card` integer, required
    - `exempt` integer, required
    - `credit_used_usd` number, required
  - `rows` CreditRow[], required
    - `team_id` string, required
    - `team_name` string, required
    - `created_at` string, date-time, nullable
    - `owner_email` string, nullable
    - `tier` string, nullable
    - `granted_usd` number, required
    - `used_usd` number, required
    - `left_usd` number, required
    - `state` 'free' | 'used' | 'card' | 'exempt', required
    - `exempt_why` 'platform' | 'owner' | 'sim' | 'test', nullable
    - `blocks` boolean
    - `card` CardOnFile — The team's most relevant subscription (a live one first).
      - `status` string, required
      - `livemode` boolean, required
      - `current_period_end` string, date-time, nullable
    - `counted_since` string, date-time, required
    - `last_spend_at` string, date-time, nullable
  - `rows_total` integer, required

## Other responses

- `422` — Validation Error

## Changes

> 32 revisions in range; 1 not diffed.

- **2026-09-27** `b09e3c4ee2af` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/stormy/apis/stormy-control-plane/changes/v1/me/admin/credits/get.md)

---

[API](https://skmtc.dev/stormy/apis/stormy-control-plane.md) · [All operations](https://skmtc.dev/stormy/apis/stormy-control-plane/llms.txt) · [OpenAPI document](https://skmtc.dev/stormy/apis/stormy-control-plane/revisions/b09e3c4ee2af?raw)