Billing

Plan, usage and limits. 1 endpoint, each also a tool for your AI through MCP. Authentication and errors are on the overview.

Plan, subscription status, emails and AI drafts used this period

GET/api/v1/billing

MCP tool get_billingRead-only

Returns

planrequiredstring | null
planNamerequiredstring | null
intervalrequired"month" | "year" | null
statusrequiredstring | null
emailsPerMonthrequiredinteger
contactsrequiredinteger
emailsSentThisPeriodrequiredinteger
renewsAtrequiredstring | null
cancelAtPeriodEndrequiredboolean
enabledrequiredboolean
payerIsYourequiredboolean
aiDraftsrequiredobject: Write with AI drafts this month: one draft = one write_sequence or website draft call
dedicatedIpsrequiredobject

cURL

curl https://ballast.to/api/v1/billing \
  -H "Authorization: Bearer $BALLAST_API_KEY"

Plan, usage and limits. 1 endpoint, each also a tool for your AI through MCP. Authentication and errors are on the overview.

GET/api/v1/billing

MCP tool get_billingRead-only

Returns

planrequiredstring | null
planNamerequiredstring | null
intervalrequired"month" | "year" | null
statusrequiredstring | null
emailsPerMonthrequiredinteger
contactsrequiredinteger
emailsSentThisPeriodrequiredinteger
renewsAtrequiredstring | null
cancelAtPeriodEndrequiredboolean
enabledrequiredboolean
payerIsYourequiredboolean
aiDraftsrequiredobject: Write with AI drafts this month: one draft = one write_sequence or website draft call
dedicatedIpsrequiredobject

cURL

curl https://ballast.to/api/v1/billing \
  -H "Authorization: Bearer $BALLAST_API_KEY"