# Choose or change the plan

**POST /billing/plan**

Puts the organization on a self-serve tier in pay-as-you-go mode, or changes its tier or cadence (monthly by default, annual for an annual-only tier); a change settles the current base fee at once and returns the net amount in `prorationCents` (0 on a first selection), and a first selection also moves the organization off any legacy subscription. When no card is on file, `paymentRequired` is true and `setupSessionUrl` links to a card setup page, so `successUrl` and `cancelUrl` are then required (400 otherwise). Requires an org admin, owner or billing role; returns 403 while self-serve plan selection is not available and 400 for a monthly cadence on an annual-only tier.


## Servers
- http://api.example.com: http://api.example.com ()


## Authentication methods
- Access token


## Parameters
### Headers

- **organization** (string)
  id of the selected (active) organization




### Body: application/json (object)

- **tier** (string)

- **cadence** (string)

- **successUrl** (string)

- **cancelUrl** (string)



## Responses
### 200


#### Body: application/json (object)
- **data** (object)

- **statusCode** (number)

- **timestamp** (string(date-time))



[Powered by Bump.sh](https://bump.sh)