TODO for AI API

billing

Endpoint

Billing getBalance

GET

https://api.todofor.ai/api/v1

/billing/balance

Retrieves the current billing balance for the authenticated user.

Billing getBalance › Responses

Successful response

manualBalancenumber · required
subscriptionBalancenumber · required

Billing getTransactions

GET

https://api.todofor.ai/api/v1

/billing/transactions

Returns a paginated list of billing transactions for the user.

Billing getTransactions › Responses

Successful response

transactionsobject[] · required
totalnumber · required
pagenumber · required
limitnumber · required
totalPagesnumber · required

Billing getInvoices

GET

https://api.todofor.ai/api/v1

/billing/invoices

Returns a paginated list of invoices for the user.

Billing getInvoices › Responses

Successful response

invoicesobject[] · required
hasMoreboolean · required

nextCursorstring

Billing createPaymentIntent

POST

https://api.todofor.ai/api/v1

/billing/create-payment-intent

Creates a Stripe payment intent for adding credits to the account.

Billing createPaymentIntent › Request Body

amountnumber · required

paymentMethodIdstring

Billing createPaymentIntent › Responses

Successful response

clientSecretstring · required
subtotalnumber · required
taxAmountnumber · required
totalAmountnumber · required

Billing setupPaymentMethod

POST

https://api.todofor.ai/api/v1

/billing/setup-payment-method

Creates a Stripe setup intent for adding a new payment method.

Billing setupPaymentMethod › Request Body

Billing setupPaymentMethod › Responses

Successful response

clientSecretstring · required

Billing getPaymentMethods

GET

https://api.todofor.ai/api/v1

/billing/payment-methods

Returns all saved payment methods for the user.

Billing getPaymentMethods › Responses

Successful response

paymentMethodsobject[] · required

defaultPaymentMethodId

Billing setDefaultPaymentMethod

POST

https://api.todofor.ai/api/v1

/billing/set-default-payment-method

Sets a payment method as the default for future transactions.

Billing setDefaultPaymentMethod › Request Body

paymentMethodIdstring · required

Billing setDefaultPaymentMethod › Responses

Successful response

null

Billing deletePaymentMethod

DELETE

https://api.todofor.ai/api/v1

/billing/payment-methods/{paymentMethodId}

Removes a saved payment method from the user account.

Billing deletePaymentMethod › path Parameters

paymentMethodIdstring · required

Billing deletePaymentMethod › Request Body

paymentMethodIdstring · required

Billing deletePaymentMethod › Responses

Successful response

null

Billing getSubscription

GET

https://api.todofor.ai/api/v1

/billing/subscription

Get current subscription status for the authenticated user.

Billing getSubscription › Responses

Successful response

subscriptionIdrequired
tierrequired
scale is legacy: no longer sold, kept so existing subscriptions resolve.
statusrequired
currentPeriodEndrequired
usageThisMonthnumber · required
usageLimitrequired
billingCycleStartrequired
everPaidboolean · required
Ever made a real Stripe payment (top-up or paid plan) — lifetime full model catalog.
intervalrequired
How the active subscription is billed; null for free/none. Plan changes must stay on this interval, so the pricing toggle follows it.
seatsrequired
Purchased seats on a per-seat Team plan; null otherwise.

Billing createSubscription

POST

https://api.todofor.ai/api/v1

/billing/subscription

Create a new subscription.

Billing createSubscription › Request Body

tierrequired
intervalrequired

couponCodestring
Optional Stripe promotion code (customer-facing, e.g. "LAUNCH100") to pre-apply at checkout.
seatsobject
Purchased seat counts for a paid team (Stripe line-item quantities).
currency
Checkout currency; default usd. huf = the Hungarian pricing page.

Billing createSubscription › Responses

Successful response

successboolean · required

subscriptionIdstring
clientSecretstring
checkoutUrlstring
messagestring

Billing cancelSubscription

DELETE

https://api.todofor.ai/api/v1

/billing/subscription

Cancel the current subscription.

Billing cancelSubscription › Request Body

cancelAtPeriodEndboolean · required

Billing cancelSubscription › Responses

Successful response

successboolean · required

subscriptionIdstring
clientSecretstring
checkoutUrlstring
messagestring

Billing updateSubscription

PATCH

https://api.todofor.ai/api/v1

/billing/subscription

Update subscription tier (upgrade/downgrade).

Billing updateSubscription › Request Body

newTierrequired

interval
couponCodestring
Optional promo code — only applied when upgrading from a free tier to a first paid plan.
seatsobject
Purchased seat counts for a paid team (Stripe line-item quantities).
currency
Checkout currency when coming from a free/local plan; a live subscription keeps its own.

Billing updateSubscription › Responses

Successful response

successboolean · required

subscriptionIdstring
clientSecretstring
checkoutUrlstring
messagestring

Billing getSubscriptionPlans

GET

https://api.todofor.ai/api/v1

/billing/subscription/plans

Get available subscription plans with pricing.

Billing getSubscriptionPlans › Responses

Successful response

plansobject[] · required

Billing syncAppleTransaction

POST

https://api.todofor.ai/api/v1

/billing/subscription/apple

Verify a signed StoreKit transaction and apply it to the account (iOS in-app purchase).

Billing syncAppleTransaction › Request Body

jwsstring · required

Billing syncAppleTransaction › Responses

Successful response

subscriptionIdrequired
tierrequired
scale is legacy: no longer sold, kept so existing subscriptions resolve.
statusrequired
currentPeriodEndrequired
usageThisMonthnumber · required
usageLimitrequired
billingCycleStartrequired
everPaidboolean · required
Ever made a real Stripe payment (top-up or paid plan) — lifetime full model catalog.
intervalrequired
How the active subscription is billed; null for free/none. Plan changes must stay on this interval, so the pricing toggle follows it.
seatsrequired
Purchased seats on a per-seat Team plan; null otherwise.

Billing getSubscriptionBilling

GET

https://api.todofor.ai/api/v1

/billing/subscription/billing

Verified recurring price, currency, interval and status of your own subscription, and whether Team seats can be changed.

Billing getSubscriptionBilling › Responses

Successful response

providerrequired
subscriptionIdrequired
tierrequired
scale is legacy: no longer sold, kept so existing subscriptions resolve.
statusrequired
Raw Stripe status when provider = stripe, else the stored status.
currencyrequired
intervalrequired
recurringSubtotalrequired
Σ unit price × quantity of the live items, minor units, before discounts/tax.
cancelAtPeriodEndboolean · required
currentPeriodEndrequired
ms
seatsrequired
Purchased seats per Stripe items; null on a legacy fixed Team or non-seat plan.
seatPricesrequired
Live item price per kind; a kind not on the subscription uses the configured seat price in the same currency/interval.
occupiedrequired
Seats in use, owner included — the lowest totals the editor may pick.
legacyTeamboolean · required
Fixed-price Team subscription: saving seats migrates it to Standard/Premium seat pricing.
canEditSeatsboolean · required
seatEditBlockedReasonrequired
seatEditMessagerequired
pendingSeatChangeboolean · required
A seat change is waiting on payment.

pendingSeatPaymentobject
How to finish that payment (owner only — this is their own subscription).
unconfirmedQuoteIdstring
A submitted seat change whose outcome is unknown; confirmTeamSeatChange with it (safe to repeat) resolves it.

Billing getTeamSeatQuote

POST

https://api.todofor.ai/api/v1

/billing/team/seats/quote

Preview (via Stripe) the cost of changing your Team Standard/Premium seats. Owner only; nothing is charged.

Billing getTeamSeatQuote › Request Body

seatsobject · required
Purchased seat counts for a paid team (Stripe line-item quantities).

Billing getTeamSeatQuote › Responses

Successful response

quoteIdstring · required
subscriptionIdstring · required
seatsobject · required
Purchased seat counts for a paid team (Stripe line-item quantities).
previousSeatsrequired
legacyMigrationboolean · required
currencyrequired
intervalrequired
seatPricesobject · required
Price per seat per billing interval, minor units of SubscriptionBilling.currency.
recurringSubtotalnumber · required
New recurring subtotal per interval (minor units, before discounts/tax).
previousRecurringSubtotalnumber · required
amountDuenumber · required
Every change is prorated immediately (Stripe always_invoice): amountDue is charged now; a negative total is credited to the customer's Stripe balance. Money, minor units of currency.
totalnumber · required
Stripe preview invoice total; negative = credit to the customer balance.
linesobject[] · required
allowanceDeltanumber · required
Usage credits (not money) added to (>0) or removed from (<0) the team's allowance when the change applies: the pool difference prorated to the rest of the current allowance period. Applied exactly once, together with the Stripe change (after payment if one is required). A removal is reserved at confirm and refused if those credits are already used.
allowancePeriodEndnumber · required
ms — end of the allowance period allowanceDelta is prorated to.
prorationDatenumber · required
ms
currentPeriodEndnumber · required
expiresAtnumber · required
ms — confirm before this; a submitted quote's retries resolve regardless.

Billing confirmTeamSeatChange

POST

https://api.todofor.ai/api/v1

/billing/team/seats/confirm

Apply a previously quoted Team seat change. Safe to retry with the same quoteId.

Billing confirmTeamSeatChange › Request Body

quoteIdstring · required

Billing confirmTeamSeatChange › Responses

Successful response

successboolean · required

subscriptionIdstring
clientSecretstring
checkoutUrlstring
messagestring

Billing getUsageStatus

GET

https://api.todofor.ai/api/v1

/billing/usage

Get usage status: balances, monthly plan usage, and anchored session/weekly rate-limit windows. Pass projectId to see the pool that funds work in that project (a team's, if it is a team project).

Billing getUsageStatus › Responses

Successful response

totalBalancenumber · required
manualBalancenumber · required
subscriptionBalancenumber · required
tierrequired
scale is legacy: no longer sold, kept so existing subscriptions resolve.
hasActivePaidSubscriptionboolean · required
allowExtraSpendboolean · required
creditLimitnumber · required
monthlyTopUprequired
percentUsednumber · required
usageThisMonthnumber · required
billingCycleStartrequired
sessionrequired
weeklyrequired

fundedByTeamOwnerIdstring
Set when this is a TEAM's pool, not the user's own: the paying team's owner id. Undefined = the user's own account funds work here.

Billing getTeams

GET

https://api.todofor.ai/api/v1

/billing/teams

List every team the authenticated user belongs to, as owner or member.

Billing getTeams › Responses

Successful response

ownerIdstring · required
The team is addressed by its funding owner on this API.
organizationIdstring · required
The organization row behind it (better-auth organization plugin / SSO).
ownerEmailstring · required
maxSeatsnumber · required
isOwnerboolean · required
myRolerequired
Role of a user within a team (IAM). owner: billing + full control; admin: manage members; member: belongs only.
canManageboolean · required
activeboolean · required
promoBoostboolean · required
membersobject[] · required
invitesobject[] · required

ownerNamestring
namestring
Organization display name.
tier
The owner's subscriptionTier: tells a free team from a paid/legacy one (with active for dormant).
premiumSeatsnumber
Premium seats bought on a per-seat plan; undefined on fixed plans.
ownerSeatType
The owner's own seat on a per-seat plan.
joinDomainstring
Email domain that auto-joins this team on signup/sign-in; undefined = off.
eligibleDomainstring
Domain the owner is eligible to enable (their own, when not a public mail provider).
teamProjectIdsstring[]
The team's shared projects: every member holds write access, and work inside one of them is billed to THIS team's pool. Empty = not set up yet. Optional until the multi-team backend lands.
teamLandingProjectIdstring
The team project a new member lands in on join (their /). One of teamProjectIds; managers may re-point it. Unset when the team has none.

teamProjectIdstring · deprecated · required

Billing addTeamMember

POST

https://api.todofor.ai/api/v1

/billing/team/members

Invite someone to the team by email — emails a join link they must accept.

Billing addTeamMember › Request Body

emailstring · required

role
ownerIdstring
Team to act on, identified by its owner's user id.

Billing addTeamMember › Responses

Successful response

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = null
	type = object · requires: ownerId, organizationId, ownerEmail +8 more

Properties for Variant 1:

null

Billing revokeTeamInvite

DELETE

https://api.todofor.ai/api/v1

/billing/team/invites

Cancel a pending invite (owner or admin).

Billing revokeTeamInvite › Request Body

emailstring · required

ownerIdstring
Team to act on, identified by its owner's user id.

Billing revokeTeamInvite › Responses

Successful response

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = null
	type = object · requires: ownerId, organizationId, ownerEmail +8 more

Properties for Variant 1:

null

Billing setTeamProject

PATCH

https://api.todofor.ai/api/v1

/billing/team/project

Attach/detach one of the owner's projects as a shared team project (owner/admin). Members get write access and work there is billed to the team pool.

Billing setTeamProject › Request Body

projectIdstring · required
Project to attach/detach — must be owned by the team owner. Required: a team may hold several projects, so there is no "the" one to infer.
isTeamProjectboolean · required
true = shared team project (members get write access, spend draws the pool).

ownerIdstring
Team to act on, identified by its owner's user id.

Billing setTeamProject › Responses

Successful response

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = null
	type = object · requires: ownerId, organizationId, ownerEmail +8 more

Properties for Variant 1:

null

Billing setTeamLandingProject

PATCH

https://api.todofor.ai/api/v1

/billing/team/landing-project

Pick which team project new members land in on join (owner/admin). Must already be a team project.

Billing setTeamLandingProject › Request Body

projectIdstring · required
Must already be one of the team's projects.

ownerIdstring
Team to act on, identified by its owner's user id.

Billing setTeamLandingProject › Responses

Successful response

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = null
	type = object · requires: ownerId, organizationId, ownerEmail +8 more

Properties for Variant 1:

null

Billing setTeamJoinDomain

PATCH

https://api.todofor.ai/api/v1

/billing/team/join-domain

Enable/disable auto-join for everyone on the owner's company email domain (owner only).

Billing setTeamJoinDomain › Request Body

enabledboolean · required
true = auto-join on the owner's verified email domain, false = off.

ownerIdstring
Team to act on, identified by its owner's user id.

Billing setTeamJoinDomain › Responses

Successful response

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = null
	type = object · requires: ownerId, organizationId, ownerEmail +8 more

Properties for Variant 1:

null

Billing previewTeamInvite

GET

https://api.todofor.ai/api/v1

/billing/team/invites/{token}

Preview an invite before signing in. Non-consuming.

Billing previewTeamInvite › path Parameters

tokenstring · required

Billing previewTeamInvite › Responses

Successful response

ownerEmailstring · required
Masked (j***@acme.com) — a forwarded link must not leak the owner's address.
emailstring · required
Full invited address — the invite email already contains it, and the sign-in form prefills from it.
rolerequired
Role of a user within a team (IAM). owner: billing + full control; admin: manage members; member: belongs only.
teamNamestring · required

Billing declineTeamInvite

POST

https://api.todofor.ai/api/v1

/billing/team/invites/decline

Turn down a team invite (signed in as the invited address).

Billing declineTeamInvite › Request Body

tokenstring · required

Billing declineTeamInvite › Responses

Successful response

null

Billing acceptTeamInvite

POST

https://api.todofor.ai/api/v1

/billing/team/invites/accept

Accept an invite as the signed-in user (email must match the invited address).

Billing acceptTeamInvite › Request Body

tokenstring · required

Billing acceptTeamInvite › Responses

Successful response

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = null
	type = object · requires: ownerId, organizationId, ownerEmail +8 more

Properties for Variant 1:

null

Billing setTeamMemberRole

PATCH

https://api.todofor.ai/api/v1

/billing/team/members/{memberId}/role

Promote/demote a team member between admin and member (owner only).

Billing setTeamMemberRole › path Parameters

memberIdstring · required

Billing setTeamMemberRole › Request Body

memberIdstring · required
rolerequired
Role of a user within a team (IAM). owner: billing + full control; admin: manage members; member: belongs only.

Billing setTeamMemberRole › Responses

Successful response

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = null
	type = object · requires: ownerId, organizationId, ownerEmail +8 more

Properties for Variant 1:

null

Billing setTeamMemberSeat

PATCH

https://api.todofor.ai/api/v1

/billing/team/members/{memberId}/seat

Move a team member between Standard and Premium seats (owner only).

Billing setTeamMemberSeat › path Parameters

memberIdstring · required

Billing setTeamMemberSeat › Request Body

memberIdstring · required
seatTyperequired

Billing setTeamMemberSeat › Responses

Successful response

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = null
	type = object · requires: ownerId, organizationId, ownerEmail +8 more

Properties for Variant 1:

null

Billing removeTeamMember

DELETE

https://api.todofor.ai/api/v1

/billing/team/members/{memberId}

Remove a team member (owner) or leave the team (member).

Billing removeTeamMember › path Parameters

memberIdstring · required

Billing removeTeamMember › Request Body

memberIdstring · required

ownerIdstring
Team to act on, identified by its owner's user id.

Billing removeTeamMember › Responses

Successful response

null

Billing setAllowExtraSpend

PATCH

https://api.todofor.ai/api/v1

/billing/extra-spend

Opt in/out of extra usage: when subscription usage windows are exhausted, continue from manual credit.

Billing setAllowExtraSpend › Request Body

allowboolean · required

Billing setAllowExtraSpend › Responses

Successful response

null

auth businessContext