Get what new seats cost

GET /organization/{id}/billing/seat-quote

Whether adding people costs money now, and how much. `state` is `charged_on_join` (Stripe says the subscription is active or past due and collecting: the seats are billed a few minutes after the people join, grouped with other changes), `trial` (Stripe says trialing: nothing is billed until the trial ends) or `none`. `seats_added` is how many paid seats they add after the one-seat minimum. With `role_id`, a free role answers `none`. Requires any of `member:manage`, `billing:view`, `sso:manage` or `org:manage`; the amounts are `null` without `billing:view`, when Stripe could not be reached, and when the preview came back truncated. Amounts are in major units of `currency`, after pre-tax reductions such as a coupon.

Path Parameters

idstring

required·

Organization id (org_…).

Query Parameters

role_idstring

The role they would join with (role_…). A free role answers none.

seatsinteger

How many people would join on that role. Above 1000 is read as 1000; anything else that is not a whole number of at least 1 as 1.

Response Body

amount_due_on_joinnumber,null

Billed for the new seats, for the rest of the current period.

currencystring,null

Lowercase ISO code.

intervalstring,null

Possible values:

dayweekmonthyearnull

interval_countinteger,null

pending_earliernumber,null

Already owed on the subscription from earlier changes, billed on the same invoice.

period_endstring,null · date-time

seat_pricenumber,null

One seat's recurring price.

seats_addedinteger

Paid seats the people add, after the one-seat minimum. 0 with none.

statestring

Possible values:

charged_on_jointrialnone

curl -X GET 'https://api.elaichi.ai/organization/<id>/billing/seat-quote' \
  -H 'Authorization: Bearer $ELAICHI_API_TOKEN' \
  -H 'Content-Type: application/json'

const response = await fetch('https://api.elaichi.ai/organization/<id>/billing/seat-quote', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer ' + process.env.ELAICHI_API_TOKEN,
    'Content-Type': 'application/json',
  },
});

const data = await response.json();
console.log(data);

import os
import requests

url = "https://api.elaichi.ai/organization/<id>/billing/seat-quote"
headers = {
    "Authorization": f"Bearer {os.environ['ELAICHI_API_TOKEN']}",
    "Content-Type": "application/json",
}

response = requests.get(url, headers=headers)
print(response.json())