پرش به مستندات
API

صورت‌حساب

هر عملیات در این گروه: آنچه می‌پذیرد، آنچه برمی‌گرداند و خطاهایی که ممکن است با آن‌ها پاسخ دهد.

عملیات‌ها

The plan of the workspace and what it costs, as Plans & Billing shows them: what the plan includes and how much of it is used, the plans on sale, pay as you go, every charge with its invoice, and the links that start a checkout or open the billing portal.

Billing belongs to the owner of the workspace. An API key acts for the owner, and an OAuth access token reaches billing only when the owner connected the app with every address. A token that acts for a member is refused with owner_only, and a key or token limited to particular addresses or domains with capability_unsupported. Reading needs billing:read, every change needs billing:write, and an OAuth access token needs a verification code for every change.

Nothing is paid through the API. Starting a checkout, opening the billing portal and adding a card for pay as you go each return a link to the billing provider's page, where the person pays, changes the card or cancels, as they do from the app.

GET/billing

Read the plan

محدوده‌های دسترسیbilling:readمی‌خواند

The plan of the workspace and what it includes: the billing interval, when it renews or ends and the next charge, how many domains it holds, how much of the sends and AI actions are used, and pay as you go. metered is false when billing is off on this install, and then nothing is capped.

Billing belongs to the owner of the workspace. An API key acts for the owner, and an OAuth access token reaches billing only when the owner connected the app with every address. A token that acts for a member is refused with owner_only, and a key or token limited to particular addresses or domains with capability_unsupported. Reading needs billing:read, every change needs billing:write, and an OAuth access token needs a verification code for every change.

Requires the billing:read scope.

خروجی

The plan and what it includes.

خطاها

خطاهایی که هر عملیاتی ممکن است برگرداند400401403404422500فهرست خطاها

همچنین در دسترس در

SDK
billing.get()
CLI
openemail billing get
MCP
getBilling

GET/billing/plans

List the plans

محدوده‌های دسترسیbilling:readمی‌خواند

Every plan, cheapest first, with its price and what it includes. available says whether it is sold on this install, and intervals the billing intervals it is sold at.

Billing belongs to the owner of the workspace. An API key acts for the owner, and an OAuth access token reaches billing only when the owner connected the app with every address. A token that acts for a member is refused with owner_only, and a key or token limited to particular addresses or domains with capability_unsupported. Reading needs billing:read, every change needs billing:write, and an OAuth access token needs a verification code for every change.

Requires the billing:read scope.

خروجی

Every plan.

خطاها

خطاهایی که هر عملیاتی ممکن است برگرداند400401403404422500فهرست خطاها

همچنین در دسترس در

SDK
billing.listPlans()
CLI
openemail billing list-plans
MCP
listBillingPlans

GET/billing/usage

Read the usage history

محدوده‌های دسترسیbilling:readمی‌خواند

Sends and AI actions per day, and what pay as you go extras cost per month, as the Usage charts show them.

Billing belongs to the owner of the workspace. An API key acts for the owner, and an OAuth access token reaches billing only when the owner connected the app with every address. A token that acts for a member is refused with owner_only, and a key or token limited to particular addresses or domains with capability_unsupported. Reading needs billing:read, every change needs billing:write, and an OAuth access token needs a verification code for every change.

Requires the billing:read scope.

پارامترهای کوئری

daysinteger | string

How many days back to go, 1 to 3660, or all for every day since the workspace was made. 30 by default.

پیش‌فرض30

خروجی

Usage per day and extras per month.

خطاها

خطاهایی که هر عملیاتی ممکن است برگرداند400401403404422500فهرست خطاها

همچنین در دسترس در

SDK
billing.getUsage()
CLI
openemail billing get-usage
MCP
getBillingUsage

GET/billing/alerts

List the billing alerts

محدوده‌های دسترسیbilling:readمی‌خواند

What the billing banner of the app would say now, most urgent first: a failed payment, paused pay as you go, sending or AI paused at a limit, a plan about to end, an allowance nearly used and a charge coming soon. An empty list means there is nothing to say.

Billing belongs to the owner of the workspace. An API key acts for the owner, and an OAuth access token reaches billing only when the owner connected the app with every address. A token that acts for a member is refused with owner_only, and a key or token limited to particular addresses or domains with capability_unsupported. Reading needs billing:read, every change needs billing:write, and an OAuth access token needs a verification code for every change.

Requires the billing:read scope.

خروجی

The alerts, most urgent first.

خطاها

خطاهایی که هر عملیاتی ممکن است برگرداند400401403404422500فهرست خطاها

همچنین در دسترس در

SDK
billing.listAlerts()
CLI
openemail billing list-alerts
MCP
listBillingAlerts

GET/billing/countries

List the billing countries

محدوده‌های دسترسیbilling:readمی‌خواند

Every country a billing address can be in, as two-letter ISO 3166 codes, the values country takes on PUT /billing/invoices/{orderId}/details.

Billing belongs to the owner of the workspace. An API key acts for the owner, and an OAuth access token reaches billing only when the owner connected the app with every address. A token that acts for a member is refused with owner_only, and a key or token limited to particular addresses or domains with capability_unsupported. Reading needs billing:read, every change needs billing:write, and an OAuth access token needs a verification code for every change.

Requires the billing:read scope.

خروجی

Every country code.

خطاها

خطاهایی که هر عملیاتی ممکن است برگرداند400401403404422500فهرست خطاها

همچنین در دسترس در

SDK
billing.listCountries()
CLI
openemail billing list-countries
MCP
listBillingCountries

GET/billing/pay-as-you-go

Read pay as you go

محدوده‌های دسترسیbilling:readمی‌خواند

Whether usage past the allowances is billed, the monthly limit and what extras cost so far, the limits that can be chosen, the prices, and the current billing period of pay as you go once it is set up.

Billing belongs to the owner of the workspace. An API key acts for the owner, and an OAuth access token reaches billing only when the owner connected the app with every address. A token that acts for a member is refused with owner_only, and a key or token limited to particular addresses or domains with capability_unsupported. Reading needs billing:read, every change needs billing:write, and an OAuth access token needs a verification code for every change.

Requires the billing:read scope.

خروجی

Pay as you go on this workspace.

خطاها

خطاهایی که هر عملیاتی ممکن است برگرداند400401403404422500فهرست خطاها

همچنین در دسترس در

SDK
billing.getPayAsYouGo()
CLI
openemail billing get-pay-as-you-go
MCP
getPayAsYouGo

PATCH/billing/pay-as-you-go

Turn pay as you go on or off

محدوده‌های دسترسیbilling:writeداده‌ها را تغییر می‌دهد
کد تأیید می‌خواهد

Turns pay as you go on or off, as the switch on Plans & Billing does. Off takes effect at once, and usage stops at the allowances. On takes effect at once when a card is already saved. The first time, checkoutUrl is a link where the person adds a card, and pay as you go starts once they have: call POST /billing/pay-as-you-go/confirm after they return. activating means a card was just saved and it is being turned on. theme and locale style the page the link opens.

Nothing is paid through the API. Starting a checkout, opening the billing portal and adding a card for pay as you go each return a link to the billing provider's page, where the person pays, changes the card or cancels, as they do from the app.

Billing belongs to the owner of the workspace. An API key acts for the owner, and an OAuth access token reaches billing only when the owner connected the app with every address. A token that acts for a member is refused with owner_only, and a key or token limited to particular addresses or domains with capability_unsupported. Reading needs billing:read, every change needs billing:write, and an OAuth access token needs a verification code for every change.

Requires the billing:write scope.

بدنهٔ درخواست

themestring

light or dark, for the page the link opens.

یکی از"light""dark"
localestring

A language tag such as de or pt-PT, for the page the link opens.

تا 35 نویسه
enabledbooleanالزامی

true to turn it on, false to turn it off.

خروجی

What happened.

خطاها

403

The key lacks the scope, or may not send as that address.

step_up_required: the call was made with an OAuth access token that has not been verified in the last 60 minutes. Ask for a code with POST /security/step-up, send it to POST /security/step-up/verify, then repeat the call. The person can also choose Allow changes for 60 minutes on the app in Account settings, Connected apps, on the OpenEmail website. An API key is never asked for a code.

503

billing_not_configured: pay as you go is not set up on this install.

خطاهایی که هر عملیاتی ممکن است برگرداند400401404422500فهرست خطاها

همچنین در دسترس در

SDK
billing.setPayAsYouGo()
CLI
openemail billing set-pay-as-you-go
MCP
setPayAsYouGo

PUT/billing/pay-as-you-go/limit

Set the pay as you go limit

محدوده‌های دسترسیbilling:writeداده‌ها را تغییر می‌دهد
کد تأیید می‌خواهد

Sets the monthly spending limit of pay as you go, one of the amounts GET /billing/pay-as-you-go lists in limits. Extras stop for the rest of a calendar month once it is reached.

Billing belongs to the owner of the workspace. An API key acts for the owner, and an OAuth access token reaches billing only when the owner connected the app with every address. A token that acts for a member is refused with owner_only, and a key or token limited to particular addresses or domains with capability_unsupported. Reading needs billing:read, every change needs billing:write, and an OAuth access token needs a verification code for every change.

Requires the billing:write scope.

بدنهٔ درخواست

limitCentsintegerالزامی

The monthly limit in US cents.

یکی از100025005000100002500050000100000250000500000

خروجی

The limit.

خطاها

403

The key lacks the scope, or may not send as that address.

step_up_required: the call was made with an OAuth access token that has not been verified in the last 60 minutes. Ask for a code with POST /security/step-up, send it to POST /security/step-up/verify, then repeat the call. The person can also choose Allow changes for 60 minutes on the app in Account settings, Connected apps, on the OpenEmail website. An API key is never asked for a code.

409

pay_as_you_go_not_enrolled: pay as you go has never been set up on this workspace.

خطاهایی که هر عملیاتی ممکن است برگرداند400401404422500فهرست خطاها

همچنین در دسترس در

SDK
billing.setPayAsYouGoLimit()
CLI
openemail billing set-pay-as-you-go-limit
MCP
setPayAsYouGoLimit

POST/billing/pay-as-you-go/confirm

Confirm pay as you go

محدوده‌های دسترسیbilling:writeداده‌ها را تغییر می‌دهد
کد تأیید می‌خواهد

Checks with the billing provider whether the card from a pay as you go checkout was saved, and records it, as the app does when the person comes back from the checkout. enabled says whether pay as you go is on now. It is safe to call again.

Billing belongs to the owner of the workspace. An API key acts for the owner, and an OAuth access token reaches billing only when the owner connected the app with every address. A token that acts for a member is refused with owner_only, and a key or token limited to particular addresses or domains with capability_unsupported. Reading needs billing:read, every change needs billing:write, and an OAuth access token needs a verification code for every change.

Requires the billing:write scope.

خروجی

Whether pay as you go is on.

خطاها

403

The key lacks the scope, or may not send as that address.

step_up_required: the call was made with an OAuth access token that has not been verified in the last 60 minutes. Ask for a code with POST /security/step-up, send it to POST /security/step-up/verify, then repeat the call. The person can also choose Allow changes for 60 minutes on the app in Account settings, Connected apps, on the OpenEmail website. An API key is never asked for a code.

خطاهایی که هر عملیاتی ممکن است برگرداند400401404422500فهرست خطاها

همچنین در دسترس در

SDK
billing.confirmPayAsYouGo()
CLI
openemail billing confirm-pay-as-you-go
MCP
confirmPayAsYouGo

POST/billing/checkout

Start a checkout

محدوده‌های دسترسیbilling:writeداده‌ها را تغییر می‌دهد
کد تأیید می‌خواهد

Starts buying a paid plan for a workspace on Free, as choosing a plan in the app does, and returns the link to the checkout. Nothing is charged until the person pays there, and the plan starts once they have. A workspace that already pays for a plan changes it on the billing portal instead.

Nothing is paid through the API. Starting a checkout, opening the billing portal and adding a card for pay as you go each return a link to the billing provider's page, where the person pays, changes the card or cancels, as they do from the app.

Billing belongs to the owner of the workspace. An API key acts for the owner, and an OAuth access token reaches billing only when the owner connected the app with every address. A token that acts for a member is refused with owner_only, and a key or token limited to particular addresses or domains with capability_unsupported. Reading needs billing:read, every change needs billing:write, and an OAuth access token needs a verification code for every change.

Requires the billing:write scope.

بدنهٔ درخواست

themestring

light or dark, for the page the link opens.

یکی از"light""dark"
localestring

A language tag such as de or pt-PT, for the page the link opens.

تا 35 نویسه
planstringالزامی

starter, business or enterprise.

یکی از"starter""business""enterprise"
intervalstring

month or year. Defaults to month.

یکی از"month""year"

خروجی

The link to the checkout.

خطاها

403

The key lacks the scope, or may not send as that address.

step_up_required: the call was made with an OAuth access token that has not been verified in the last 60 minutes. Ask for a code with POST /security/step-up, send it to POST /security/step-up/verify, then repeat the call. The person can also choose Allow changes for 60 minutes on the app in Account settings, Connected apps, on the OpenEmail website. An API key is never asked for a code.

409

plan_conflict: the workspace already pays for a plan.

422

plan_unavailable: the plan is not sold on this install, or not at that interval. invalid_parameter: the body did not validate.

503

billing_not_configured: paid plans are not set up on this install.

خطاهایی که هر عملیاتی ممکن است برگرداند400401404500فهرست خطاها

همچنین در دسترس در

SDK
billing.startCheckout()
CLI
openemail billing start-checkout
MCP
startPlanCheckout

POST/billing/portal

Open the billing portal

محدوده‌های دسترسیbilling:writeداده‌ها را تغییر می‌دهد
کد تأیید می‌خواهد

Returns a link to the billing portal, where the person changes or cancels the plan, updates the card and downloads past invoices, as Manage does in the app. The body is optional.

Nothing is paid through the API. Starting a checkout, opening the billing portal and adding a card for pay as you go each return a link to the billing provider's page, where the person pays, changes the card or cancels, as they do from the app.

Billing belongs to the owner of the workspace. An API key acts for the owner, and an OAuth access token reaches billing only when the owner connected the app with every address. A token that acts for a member is refused with owner_only, and a key or token limited to particular addresses or domains with capability_unsupported. Reading needs billing:read, every change needs billing:write, and an OAuth access token needs a verification code for every change.

Requires the billing:write scope.

بدنهٔ درخواست

themestring

light or dark, for the page the link opens.

یکی از"light""dark"
localestring

A language tag such as de or pt-PT, for the page the link opens.

تا 35 نویسه

خروجی

The link to the billing portal.

خطاها

403

The key lacks the scope, or may not send as that address.

step_up_required: the call was made with an OAuth access token that has not been verified in the last 60 minutes. Ask for a code with POST /security/step-up, send it to POST /security/step-up/verify, then repeat the call. The person can also choose Allow changes for 60 minutes on the app in Account settings, Connected apps, on the OpenEmail website. An API key is never asked for a code.

503

billing_not_configured: billing is not set up on this install.

خطاهایی که هر عملیاتی ممکن است برگرداند400401404422500فهرست خطاها

همچنین در دسترس در

SDK
billing.openPortal()
CLI
openemail billing open-portal
MCP
openBillingPortal

GET/billing/invoices

List the charges

محدوده‌های دسترسیbilling:readمی‌خواند

Every charge of the workspace with its invoice, as History on Plans & Billing lists them. page and limit page through them, total counts them all, and search matches the plan, the invoice number, the charge id and the name billed. metered is false when billing is off on this install.

Billing belongs to the owner of the workspace. An API key acts for the owner, and an OAuth access token reaches billing only when the owner connected the app with every address. A token that acts for a member is refused with owner_only, and a key or token limited to particular addresses or domains with capability_unsupported. Reading needs billing:read, every change needs billing:write, and an OAuth access token needs a verification code for every change.

Requires the billing:read scope.

پارامترهای کوئری

pageinteger

Which page, from 1.

دست‌کم 1پیش‌فرض1
limitinteger

Charges per page, 1 to 100.

دست‌کم 1حداکثر 100پیش‌فرض25
sortstring

Newest or oldest first.

یکی از"newest""oldest"پیش‌فرض"newest"
searchstring

Words to look for.

تا 120 نویسه

خروجی

A page of charges.

خطاها

502

billing_unreachable: the billing provider did not answer.

خطاهایی که هر عملیاتی ممکن است برگرداند400401403404422500فهرست خطاها

همچنین در دسترس در

SDK
billing.listInvoices()
CLI
openemail billing list-invoices
MCP
listInvoices

GET/billing/invoices/{orderId}

Get the invoice of a charge

محدوده‌های دسترسیbilling:readمی‌خواند

The link to the invoice of one charge, as a PDF, and its file name. An invoice that was not written yet is written first, from the billing details on the charge or on the account, which can take a few seconds. The link is signed by the billing provider, downloads the PDF and stops working after a while, so fetch it again rather than keeping it.

Billing belongs to the owner of the workspace. An API key acts for the owner, and an OAuth access token reaches billing only when the owner connected the app with every address. A token that acts for a member is refused with owner_only, and a key or token limited to particular addresses or domains with capability_unsupported. Reading needs billing:read, every change needs billing:write, and an OAuth access token needs a verification code for every change.

Requires the billing:read scope.

پارامترهای مسیر

orderIdstringالزامی

The id of a charge, as GET /billing/invoices lists it.

خروجی

The link to the invoice.

خطاها

409

billing_details_required: the charge has no billing name and address yet. invoice_unavailable: a draft or void charge has no invoice.

502

billing_unreachable: the billing provider did not answer.

504

invoice_not_ready: the invoice is still being written.

خطاهایی که هر عملیاتی ممکن است برگرداند400401403404422500فهرست خطاها

همچنین در دسترس در

SDK
billing.getInvoice()
CLI
openemail billing get-invoice
MCP
getInvoice

PUT/billing/invoices/{orderId}/details

Save the billing details of a charge

محدوده‌های دسترسیbilling:writeداده‌ها را تغییر می‌دهد
کد تأیید می‌خواهد

Saves the name and address billed on a charge, as the Billing address dialog does, keeps the address for later charges, and starts writing its invoice. invoice is ready when the charge already had one, started when it is being written, and refused with the reason in message. Read it with GET /billing/invoices/{orderId}.

Billing belongs to the owner of the workspace. An API key acts for the owner, and an OAuth access token reaches billing only when the owner connected the app with every address. A token that acts for a member is refused with owner_only, and a key or token limited to particular addresses or domains with capability_unsupported. Reading needs billing:read, every change needs billing:write, and an OAuth access token needs a verification code for every change.

Requires the billing:write scope.

پارامترهای مسیر

orderIdstringالزامی

The id of a charge, as GET /billing/invoices lists it.

بدنهٔ درخواست

namestringالزامی

Who is billed, up to 200 characters.

1 تا 200 نویسه
line1stringالزامی

The street address, up to 200 characters.

1 تا 200 نویسه
line2string

A flat, suite or building, up to 200 characters.

تا 200 نویسه
citystringالزامی

Up to 120 characters.

1 تا 120 نویسه
postalCodestring

Up to 40 characters.

تا 40 نویسه
statestring

The state or region, up to 60 characters. In the US and Canada, its two-letter code.

تا 60 نویسه
countrystringالزامی

A two-letter ISO 3166 code, one of those listCountries returns.

یکی از"AD""AE""AF""AG""AI""AL""AM""AO""AQ""AR""AS""AT""AU""AW""AX""AZ""BA""BB""BD""BE""BF""BG""BH""BI""BJ""BL""BM""BN""BO""BQ""BR""BS""BT""BV""BW""BY""BZ""CA""CC""CD""CF""CG""CH""CI""CK""CL""CM""CN""CO""CR""CV""CW""CX""CY""CZ""DE""DJ""DK""DM""DO""DZ""EC""EE""EG""EH""ER""ES""ET""FI""FJ""FK""FM""FO""FR""GA""GB""GD""GE""GF""GG""GH""GI""GL""GM""GN""GP""GQ""GR""GS""GT""GU""GW""GY""HK""HM""HN""HR""HT""HU""ID""IE""IL""IM""IN""IO""IQ""IS""IT""JE""JM""JO""JP""KE""KG""KH""KI""KM""KN""KR""KW""KY""KZ""LA""LB""LC""LI""LK""LR""LS""LT""LU""LV""LY""MA""MC""MD""ME""MF""MG""MH""MK""ML""MM""MN""MO""MP""MQ""MR""MS""MT""MU""MV""MW""MX""MY""MZ""NA""NC""NE""NF""NG""NI""NL""NO""NP""NR""NU""NZ""OM""PA""PE""PF""PG""PH""PK""PL""PM""PN""PR""PS""PT""PW""PY""QA""RE""RO""RS""RW""SA""SB""SC""SD""SE""SG""SH""SI""SJ""SK""SL""SM""SN""SO""SR""SS""ST""SV""SX""SZ""TC""TD""TF""TG""TH""TJ""TK""TL""TM""TN""TO""TR""TT""TV""TW""TZ""UA""UG""UM""US""UY""UZ""VA""VC""VE""VG""VI""VN""VU""WF""WS""YE""YT""ZA""ZM""ZW"

خروجی

خطاها

403

The key lacks the scope, or may not send as that address.

step_up_required: the call was made with an OAuth access token that has not been verified in the last 60 minutes. Ask for a code with POST /security/step-up, send it to POST /security/step-up/verify, then repeat the call. The person can also choose Allow changes for 60 minutes on the app in Account settings, Connected apps, on the OpenEmail website. An API key is never asked for a code.

422

billing_address_rejected: the billing provider refused the address. invalid_parameter: the body did not validate.

502

billing_unreachable: the billing provider did not answer.

خطاهایی که هر عملیاتی ممکن است برگرداند400401404500فهرست خطاها

همچنین در دسترس در

SDK
billing.saveInvoiceDetails()
CLI
openemail billing save-invoice-details
MCP
saveBillingDetails

اشیا

Billingobject

objectstringالزامی
یکی از"billing"
workspaceIdstringالزامی
workspaceNamestring
planstringالزامی
یکی از"free""starter""business""enterprise"
planNamestring
meteredbooleanالزامی

False when billing is off on this install, and then nothing is capped.

intervalstring

How often the plan is billed. Null on Free.

می‌تواند null باشدیکی از"month""year"
renewsAtstring

When the plan renews, or ends when cancelAtPeriodEnd is true.

می‌تواند null باشدقالبdate-time
cancelAtPeriodEndboolean

The plan was cancelled and ends at renewsAt.

nextChargeobject

The next charge of the plan, when one is due. cents is null until it is known.

می‌تواند null باشد
centsinteger
می‌تواند null باشد
currencystring
می‌تواند null باشد
atstring
قالبdate-time
domainsobject
usedinteger

Domains in the workspace.

دست‌کم 0
includedinteger

Domains the plan includes. Null when there is no limit.

می‌تواند null باشددست‌کم 0
canAddboolean
usageobject
sendsobject
usedinteger

Used so far.

دست‌کم 0
limitinteger

What the plan includes. Null when there is no limit.

می‌تواند null باشددست‌کم 0
resetsAtstring

When the monthly sends start again.

قالبdate-time
aiActionsobject
usedinteger

Used so far.

دست‌کم 0
limitinteger

What the plan includes. Null when there is no limit.

می‌تواند null باشددست‌کم 0
resetsAtstring

When the daily AI actions start again.

قالبdate-time
payAsYouGoobject
availableboolean

Whether the plan of the workspace can buy anything past its allowances.

enabledboolean

Whether usage past the allowances is being billed now: switched on and not paused.

suspendedboolean

Paused because the last payment failed. Update the card on the billing portal to resume.

enrolledboolean

Whether pay as you go has ever been set up, with a card, on this workspace.

switchedOnboolean

Whether it is switched on, paused or not.

coversSendsboolean

Whether sends past the monthly allowance can be bought on this plan.

coversAiActionsboolean

Whether AI actions past the daily allowance can be bought on this plan.

limitCentsinteger

The monthly spending limit in US cents. Extras stop once a calendar month reaches it.

spentCentsinteger

What extras cost this calendar month so far, in US cents.

دست‌کم 0
extraSendsinteger

Sends past the allowance this month.

دست‌کم 0
extraAiActionsinteger

AI actions past the allowance this month.

دست‌کم 0
estimatedCentsinteger

What those extras come to, in US cents.

دست‌کم 0
availablePlansstring[]

The plans sold on this install.

یکی از"free""starter""business""enterprise"

BillingAlertobject

objectstringالزامی
یکی از"billing_alert"
idstringالزامی

Stays the same while the same thing is true, so a dismissed alert can stay dismissed.

kindstringالزامی
یکی از"payment_failed""pay_as_you_go_paused""sending_paused""spend_limit_reached""ai_used_up""plan_ending""sends_nearly_used""spend_nearly_reached""upcoming_charge"
severitystringالزامی
یکی از"blocked""warning""info"
targetstringالزامی

Which tab of Plans & Billing it is about: the plan or the usage.

یکی از"billing""usage"
planNamestring
می‌تواند null باشد
atstring

When it happens: the charge, the end of the plan or the reset.

می‌تواند null باشدقالبdate-time
centsinteger
می‌تواند null باشد
currencystring
می‌تواند null باشد
usedinteger
می‌تواند null باشد
limitinteger
می‌تواند null باشد
payAsYouGoboolean

Whether pay as you go can lift the limit it is about.

BillingCheckoutobject

objectstring
یکی از"checkout"
urlstring
قالبuri

BillingCountryListobject

objectstring
یکی از"list"
datastring[]

BillingInvoiceobject

objectstringالزامی
یکی از"invoice"
idstringالزامی

The charge id the invoice calls take.

createdAtstringالزامی
قالبdate-time
amountCentsintegerالزامی
subtotalCentsinteger
currencystringالزامی
statusstring
می‌تواند null باشدیکی از"draft""pending""paid""refunded""partially_refunded""void"
paidboolean
reasonstring

Why it was charged: a purchase, a renewal or a change.

invoiceNumberstring
می‌تواند null باشد
invoiceReadyboolean

Whether its invoice was written.

needsBillingDetailsboolean

Its invoice needs a billing name and address first.

billingNamestring
می‌تواند null باشد
productstring
می‌تواند null باشد
payAsYouGoboolean

A charge for pay as you go extras.

discountobject
می‌تواند null باشد
codestring
می‌تواند null باشد
namestring
می‌تواند null باشد
amountCentsinteger
percentOffnumber
می‌تواند null باشد

BillingInvoiceDetailsobject

objectstring
یکی از"invoice_details"
orderIdstring
invoicestring
یکی از"ready""started""refused"
messagestring

Why the invoice could not be started, when invoice is refused.

می‌تواند null باشد

BillingInvoiceListobject

objectstring
یکی از"list"
totalinteger

How many charges there are in all.

دست‌کم 0
pageinteger
دست‌کم 1
limitinteger
دست‌کم 1
hasMoreboolean
meteredboolean

False when billing is off on this install.

BillingPlanobject

objectstringالزامی
یکی از"plan"
idstringالزامی
یکی از"free""starter""business""enterprise"
namestringالزامی
availablebooleanالزامی

Whether it is sold on this install.

intervalsstring[]الزامی

The billing intervals it is sold at. Empty for Free.

یکی از"month""year"
monthlyPriceCentsinteger

The price billed monthly, in US cents a month.

دست‌کم 0
yearlyMonthlyPriceCentsinteger

The price billed yearly, in US cents a month.

دست‌کم 0
includedDomainsinteger

Domains it includes. Null when there is no limit.

می‌تواند null باشددست‌کم 0
monthlySendsinteger

Sends it includes each calendar month. Null when there is no limit.

می‌تواند null باشددست‌کم 0
dailyAiActionsinteger

AI actions it includes each day. Null when there is no limit.

می‌تواند null باشددست‌کم 0
teamAccessboolean

Whether members can be added.

prioritySupportboolean
extraSendsboolean

Whether pay as you go can buy sends past the allowance.

extraAiActionsboolean

Whether pay as you go can buy AI actions past the allowance.

BillingPlanListobject

objectstring
یکی از"list"

BillingPortalobject

objectstring
یکی از"billing_portal"
urlstring
قالبuri

BillingUsageobject

objectstringالزامی
یکی از"usage_history"
daysobject[]الزامی
daystring
قالبdate
aiActionsinteger

AI actions that day.

دست‌کم 0
aiExtrainteger

Of those, the ones past the daily allowance, billed by pay as you go.

دست‌کم 0
sendsinteger

Emails sent that day.

دست‌کم 0
monthsobject[]الزامی
monthstring

The month, as YYYY-MM.

extraSendsinteger

Sends billed by pay as you go.

دست‌کم 0
extraAiActionsinteger

AI actions billed by pay as you go.

دست‌کم 0
sendCentsinteger

What the extra sends cost, in US cents.

دست‌کم 0
aiCentsinteger

What the extra AI actions cost, in US cents.

دست‌کم 0
centsinteger

Both, in US cents.

دست‌کم 0
dailyAiActionsinteger

AI actions the plan includes each day. Null when there is no limit.

می‌تواند null باشددست‌کم 0
monthlySendsinteger

Sends the plan includes each month. Null when there is no limit.

می‌تواند null باشددست‌کم 0

PayAsYouGoobject

objectstringالزامی
یکی از"pay_as_you_go"
availablebooleanالزامی

Whether the plan of the workspace can buy anything past its allowances.

enabledbooleanالزامی

Whether usage past the allowances is being billed now: switched on and not paused.

suspendedboolean

Paused because the last payment failed. Update the card on the billing portal to resume.

enrolledboolean

Whether pay as you go has ever been set up, with a card, on this workspace.

switchedOnboolean

Whether it is switched on, paused or not.

coversSendsboolean

Whether sends past the monthly allowance can be bought on this plan.

coversAiActionsboolean

Whether AI actions past the daily allowance can be bought on this plan.

limitCentsinteger

The monthly spending limit in US cents. Extras stop once a calendar month reaches it.

spentCentsinteger

What extras cost this calendar month so far, in US cents.

دست‌کم 0
extraSendsinteger

Sends past the allowance this month.

دست‌کم 0
extraAiActionsinteger

AI actions past the allowance this month.

دست‌کم 0
estimatedCentsinteger

What those extras come to, in US cents.

دست‌کم 0
limitsinteger[]الزامی

The monthly limits that can be chosen, in US cents.

یکی از100025005000100002500050000100000250000500000
pricesobjectالزامی

What extras cost: priceCents US cents for every unit.

sendsobject
unitinteger
priceCentsinteger
aiActionsobject
unitinteger
priceCentsinteger
periodobject

The current billing period of pay as you go. Null until it is set up.

می‌تواند null باشد
endsAtstring
قالبdate-time
sendsinteger

Extra sends in the period.

دست‌کم 0
aiActionsinteger

Extra AI actions in the period.

دست‌کم 0
estimatedCentsinteger

What they come to, in US cents.

دست‌کم 0

PayAsYouGoConfirmationobject

objectstring
یکی از"pay_as_you_go_confirmation"
enabledboolean

PayAsYouGoLimitobject

objectstring
یکی از"pay_as_you_go_limit"
limitCentsinteger

PayAsYouGoSwitchobject

objectstring
یکی از"pay_as_you_go_switch"
enabledboolean
suspendedboolean
activatingboolean

A card was just saved, and pay as you go is being turned on.

checkoutUrlstring

Where the person adds a card, the first time pay as you go is turned on.

می‌تواند null باشد