---
search:
  tags:
    - Billing
    - POST
seo:
  description: >-
    Estimates the recurring invoice for a plan and a number of… Reference for
    the POST /organizations/{organizationId}/billing/preview endpoint in the
    Auth API.
sidebar:
  label: Estimate the recurring invoice
  badge: POST
title: Estimate the recurring invoice
type: openapi-operation
---
Estimates the recurring invoice for a plan and a number of seats. Requires being a member. With a current subscription, the estimate replaces its plan with the one asked for. A plan billed per environment minute takes no seats, and the estimate leaves out the usage billed at the end of the period. Answers 502 when Stripe fails.

`POST /organizations/{organizationId}/billing/preview`

**Request body** (`application/json`, required)

- `plan` (string) — A plan name; the default plan when omitted.
- `seats` (integer) — Licensed environments, required by a plan priced per seat. A plan billed per environment minute ignores it.

Request body example:

```json
{
  "plan": "string",
  "seats": 1
}
```

**Responses**

- `200` — The estimate.
- `default` — The request failed.

Response example, 200:

```json
{
  "currency": "string",
  "subtotal": 0,
  "tax": 0,
  "total": 0
}
```
