Billing API
Generated OpenAPI reference for the Billing API surface.
Overview
Billing endpoints are part of the public Everyn API. Organization-scoped human billing reads and owner/admin billing mutations.
Endpoints
The generated OpenAPI component below contains request parameters, request bodies, response bodies, status codes, and schemas for this tag. The static summary keeps the endpoint purpose, authentication, schema names, and API error guidance available before the interactive reference loads.
The details below are static HTML generated from the same OpenAPI schema, so they remain readable without client-side JavaScript. The interactive component after this section provides expandable examples and richer schema browsing.
Endpoint summary for quick scanning before using the generated reference:
| Method | Path | Purpose | Authentication | Request body / schema | Success response / schema | Errors |
|---|---|---|---|---|---|---|
POST | /v1/billing/stripe/webhooks | Ingest Stripe Billing Webhook | Bearer token (BearerAuth) | None. | 202 None | API errors: 400, 401, 403, 404, 409, 429 |
GET | /v1/organizations/{organization_id}/billing | Get Billing Overview | Bearer token (BearerAuth) | None. | 200 application/json: BillingOverviewResponse | API errors: 400, 401, 403, 404, 409, 422, 429 |
GET | /v1/organizations/{organization_id}/billing/cancellation | Discover Agreement Cancellation | Bearer token (BearerAuth) | None. | 200 application/json: CancellationDiscoveryNoneResponse or CancellationDiscoveryFoundResponse | API errors: 400, 401, 403, 404, 409, 422, 429 |
POST | /v1/organizations/{organization_id}/billing/cancellation | Request Agreement Cancellation | Bearer token (BearerAuth) | application/json: CancellationRequestBody | 201 application/json: CancellationResponse | API errors: 400, 401, 403, 404, 409, 422, 429 |
POST | /v1/organizations/{organization_id}/billing/cancellation/{cancellation_id}/withdrawal | Withdraw Agreement Cancellation | Bearer token (BearerAuth) | application/json: CancellationWithdrawalRequestBody | 200 application/json: CancellationResponse | API errors: 400, 401, 403, 404, 409, 422, 429 |
GET | /v1/organizations/{organization_id}/billing/history | List Billing History | Bearer token (BearerAuth) | None. | 200 application/json: BillingHistoryListResponse | API errors: 400, 401, 403, 404, 409, 422, 429 |
GET | /v1/organizations/{organization_id}/billing/history/{history_item_id} | Get Billing History Detail | Bearer token (BearerAuth) | None. | 200 application/json: BillingHistoryDetailResponse | API errors: 400, 401, 403, 404, 409, 422, 429 |
POST | /v1/organizations/{organization_id}/billing/paid-checkouts | Start Paid Checkout | Bearer token (BearerAuth) | application/json: PaidCheckoutStartRequestBody | 200 application/json: PaidCheckoutReconciledResponse201 application/json: PaidCheckoutStartResponse202 application/json: PaidCheckoutPreparingResponse | API errors: 400, 401, 403, 404, 409, 422, 429 |
POST | /v1/organizations/{organization_id}/billing/paid-checkouts/complete-return | Complete Paid Checkout Return | Bearer token (BearerAuth) | application/json: PaidCheckoutCompleteReturnRequestBody | 200 application/json: PaidCheckoutStatusResponse | API errors: 400, 401, 403, 404, 409, 422, 429 |
GET | /v1/organizations/{organization_id}/billing/paid-checkouts/{paid_checkout_intent_id} | Get Paid Checkout Status | Bearer token (BearerAuth) | None. | 200 application/json: PaidCheckoutStatusResponse | API errors: 400, 401, 403, 404, 409, 422, 429 |
POST | /v1/organizations/{organization_id}/billing/payment-method-setups | Start Payment Method Setup | Bearer token (BearerAuth) | application/json: PaymentMethodSetupStartRequestBody or null | 201 application/json: PaymentMethodSetupStartResponse | API errors: 400, 401, 403, 404, 409, 422, 429 |
POST | /v1/organizations/{organization_id}/billing/payment-method-setups/complete-return | Complete Payment Method Setup Return | Bearer token (BearerAuth) | application/json: PaymentMethodSetupCompleteReturnRequestBody | 200 application/json: PaymentSetupStatusResponse | API errors: 400, 401, 403, 404, 409, 422, 429 |
GET | /v1/organizations/{organization_id}/billing/payment-method-setups/{hosted_setup_intent_id} | Get Payment Method Setup Status | Bearer token (BearerAuth) | None. | 200 application/json: PaymentSetupStatusResponse | API errors: 400, 401, 403, 404, 409, 422, 429 |
GET | /v1/organizations/{organization_id}/billing/plan-transition | Discover Plan Transition | Bearer token (BearerAuth) | None. | 200 application/json: PlanTransitionDiscoveryNoneResponse or PlanTransitionDiscoveryFoundResponse | API errors: 400, 401, 403, 404, 409, 422, 429 |
GET | /v1/organizations/{organization_id}/billing/plan-transition-quote | Get Plan Transition Quote | Bearer token (BearerAuth) | None. | 200 application/json: PlanTransitionQuoteResponse | API errors: 400, 401, 403, 404, 409, 422, 429 |
POST | /v1/organizations/{organization_id}/billing/plan-transitions | Request Plan Transition | Bearer token (BearerAuth) | application/json: PlanTransitionRequestBody | 201 application/json: PlanTransitionStartResponse | API errors: 400, 401, 403, 404, 409, 422, 429 |
POST | /v1/organizations/{organization_id}/billing/plan-transitions/complete-return | Complete Plan Transition Return | Bearer token (BearerAuth) | application/json: PlanTransitionCompleteReturnRequestBody | 200 application/json: PlanTransitionResponse | API errors: 400, 401, 403, 404, 409, 422, 429 |
GET | /v1/organizations/{organization_id}/billing/plan-transitions/{plan_transition_id} | Get Plan Transition Status | Bearer token (BearerAuth) | None. | 200 application/json: PlanTransitionResponse | API errors: 400, 401, 403, 404, 409, 422, 429 |
POST | /v1/organizations/{organization_id}/billing/portal-sessions | Start Billing Portal Session | Bearer token (BearerAuth) | None. | 201 application/json: BillingPortalSessionResponse | API errors: 400, 401, 403, 404, 409, 422, 429 |
GET | /v1/organizations/{organization_id}/billing/recovery | Get Renewal Recovery | Bearer token (BearerAuth) | None. | 200 application/json: RenewalRecoveryResponse | API errors: 400, 401, 403, 404, 409, 422, 429 |
POST | /v1/organizations/{organization_id}/billing/recovery/stop-to-free | Stop Renewal Recovery To Free | Bearer token (BearerAuth) | application/json: RenewalRecoveryStopRequestBody | 200 application/json: RenewalRecoveryResponse | API errors: 400, 401, 403, 404, 409, 422, 429 |
PUT | /v1/organizations/{organization_id}/billing/row-budget | Change Row Budget | Bearer token (BearerAuth) | application/json: RowBudgetChangeRequestBody | 200 application/json: RowBudgetChangeResponse | API errors: 400, 401, 403, 404, 409, 422, 429 |
GET | /v1/organizations/{organization_id}/billing/statements | List Billing Statements | Bearer token (BearerAuth) | None. | 200 application/json: BillingStatementListResponse | API errors: 400, 401, 403, 404, 409, 422, 429 |
GET | /v1/organizations/{organization_id}/billing/statements/{statement_id} | Get Billing Statement | Bearer token (BearerAuth) | None. | 200 application/json: BillingStatementDetailResponse | API errors: 400, 401, 403, 404, 409, 422, 429 |
GET | /v1/organizations/{organization_id}/billing/top-up-receipts | List Top Up Receipts | Bearer token (BearerAuth) | None. | 200 application/json: TopUpReceiptListResponse | API errors: 400, 401, 403, 404, 409, 422, 429 |
POST | /v1/organizations/{organization_id}/billing/top-ups | Start Top Up | Bearer token (BearerAuth) | application/json: TopUpStartRequestBody | 201 application/json: TopUpIntentResponse | API errors: 400, 401, 403, 404, 409, 422, 429 |
GET | /v1/organizations/{organization_id}/billing/top-ups/{top_up_intent_id} | Get Top Up Status | Bearer token (BearerAuth) | None. | 200 application/json: TopUpIntentResponse | API errors: 400, 401, 403, 404, 409, 422, 429 |
Loading API reference...