# Account and credits

URL: https://docs.sigment.ai/tools/account-credits

Check the workspace, balance and prices, and send the user a top-up link.

Start every session with `get_account`, and call `quote_cost` before any paid tool.

### get_account

Workspaces, plan, credit balance, prices and today's agent spend. Call this first.

Kind: read-only

| Parameter | Type | Required | Default | Limits |
|---|---|---|---|---|
| `workspace_id` | `string` | no |  | 1–100 chars |

### quote_cost

Price an action before doing it. For analysis pass the creator handles (new analysis) or analysis_id (re-run): re-analyses of creators seen in the last 30 days cost 5 instead of 15.

Kind: read-only

| Parameter | Type | Required | Default | Limits |
|---|---|---|---|---|
| `action` | `"discovery" \| "analysis"` | yes |  |  |
| `platform` | `"instagram" \| "youtube" \| "tiktok"` | no | "instagram" |  |
| `handles` | `string[]` | no |  | 1–50 items |
| `analysis_id` | `string` | no |  | 1–100 chars |
| `workspace_id` | `string` | no |  | 1–100 chars |

### get_credit_history

Recent credit charges, refunds and top-ups for the workspace.

Kind: read-only

| Parameter | Type | Required | Default | Limits |
|---|---|---|---|---|
| `limit` | `integer` | no | 20 | 1–100 |
| `workspace_id` | `string` | no |  | 1–100 chars |

### get_topup_link

A Stripe checkout link for the HUMAN user to buy credits. Agents cannot pay: give the user the URL.

Kind: write

| Parameter | Type | Required | Default | Limits |
|---|---|---|---|---|
| `package_id` | `"starter" \| "growth" \| "scale"` | no | "starter" |  |
| `workspace_id` | `string` | no |  | 1–100 chars |