# Account types

> The challenges you sell — balance, price and the rule set each one is judged by.

Source: https://www.propexecutor.com/docs/account-types
Whole reference in one file: https://www.propexecutor.com/doc.md

An account type is the challenge you sell: a name, a starting balance, the price you charge for it, and the rule set it is judged against. “$10K Standard” is an account type. You provision trading accounts against one.

> **The price here is informational**
> `price_cents` is what *you* charge your traders, recorded so your own dashboard can display it. We never collect it — there is no checkout for a challenge in this platform, by design. See [what is not available](https://www.propexecutor.com/docs/not-available).

## List account types

`GET /v1/account-types` · **Planned** · scope `accounts:read`

| Field | Type | Description |
| --- | --- | --- |
| `id` | uuid | What you provision against. |
| `name` | string | e.g. `$10K Standard`. |
| `starting_balance` | number | What each account is funded with. |
| `price_cents` | integer | Your price, in cents. Informational. |
| `rule_set_id` | uuid | The rule set accounts of this type are judged by. |
| `created_at` | timestamp |  |

## Create one

`POST /v1/account-types` · **Planned** · scope `accounts:write`

<!-- curl -->
```bash
curl -X POST https://api.propexecutor.com/v1/account-types \
  -H "Authorization: Bearer $PFX_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "$25K Two-Step",
    "starting_balance": 25000,
    "price_cents": 19900,
    "rule_set_id": "7c4a…"
  }'
```

Several account types can point at the same rule set — a $10K and a $25K both running “Standard Rules” is the normal case, and the reason rule sets are a separate thing rather than a field on this one.

## Rename or reprice

`PATCH /v1/account-types/{id}` · **Planned** · scope `accounts:write`

> **Existing accounts do not change**
> An account froze its rule set version when it was created and is judged by that version for life. Repointing this account type at a different rule set changes what **future** accounts get, and nothing about the ones already running. There is deliberately no endpoint that can retroactively rejudge a sold account.
