# Credits


The credits of an organization billed in credits.
[Conventions](/cli/reference#conventions) apply here, except `--quiet` on
`intuizi credits`: a balance has no id, so `--quiet` is rejected as a usage
error. Use `--json` in scripts.

Credits answer only for an organization billed in credits. Any other
organization gets the API's `403` from every command here (see
[Credits](/api/v2/credits)). The balance and the statement require additional
permissions which need to be approved by your Account Manager, the same as
[usage](/cli/reference/usage). To price a build before it runs, see
[Quote](/cli/reference/audiences#quote).

## Credits

Show the credits of the current period: your contract term while today falls
in it, otherwise the calendar month.
See [Get Credits](/api/v2/credits#get-apiv2credits).

```bash
intuizi credits
```

Shows what is available and used, the share used and its `state` (`ok`, `low`
from 70%, `critical` from 90%, `out` when nothing is left), the pace in credits
a day, the day the balance runs out at that pace, and the next credits to
expire. The credits used per run type follow as a table. The split per user is
in `--json`:

```bash
intuizi credits --json | jq .data.by_user
```

## Statement

List the period's entries, newest first: credits added, runs charged, refunds,
and credits that expired. A run paid from two blocks of credits is one entry,
and `credits` is negative when credits were used.
See [Get Credits Statement](/api/v2/credits#get-apiv2creditsstatement).

| Flag | Input |
| --- | --- |
| `--search` | contains match on the audience name or the entry label |
| `--page` `--per-page` | page through the entries |

```bash
intuizi credits statement
intuizi credits statement --search refund
```

{{< cards >}}
  {{< card link="/developers/cli/reference/usage/" title="Usage" subtitle="Data scanned in a month, and the monthly limit." >}}
  {{< card link="/developers/cli/reference/audiences/" title="Audiences" subtitle="Build audiences, and quote their price first." >}}
{{< /cards >}}