# CustomDomain Billing API

**Canonical:** https://apis.io/apis/customdomain-ai/customdomain-ai-billing-api/  
**Provider:** CustomDomain — https://apis.io/providers/customdomain-ai/  
**Base URL:** https://api.customdomain.ai/v1  
**Documentation:** https://docs.customdomain.ai/docs/api-reference

CustomDomain Billing API is one of 25 APIs that [CustomDomain](https://apis.io/providers/customdomain-ai/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Billing. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 6 JSON Schemas.

Plans, metered usage, the subscription (trial, grace, invoices), checkout, and the billing portal.

## Operations (13)

| Method | Path | Summary |
|---|---|---|
| POST | `/billing/setup` | Start a Stripe Checkout session to save a payment method |
| GET | `/plans` | Public plan catalog (plus billing {configured, mode}) |
| GET | `/billing/usage` | Metered domain usage, plan, and quota for the caller's tenant |
| POST | `/billing/checkout` | Start a Stripe Checkout session for a self-serve plan |
| POST | `/billing/portal` | Open a Stripe Billing Portal session |
| GET | `/billing/notice` | Whether billing needs attention (every member) |
| GET | `/billing/standing` | Whether the workspace may connect new domains |
| GET | `/billing/status` | The workspace's subscription (owners and admins) |
| GET | `/billing/invoices` | The workspace's recent invoices (owners and admins) |
| POST | `/billing/grace:start` | Start a legacy Free workspace's grace period (owners and admins) |
| POST | `/billing/checkout:confirm` | Record a completed plan checkout now (owners and admins) |
| POST | `/billing/change-plan` | Move a running subscription to another self-serve plan |
| POST | `/billing/promotion-code` | Apply a promotion code to the running subscription |

## Machine-readable artifacts (8)

- **OpenAPI** — https://artifacts.apis.io/customdomain-ai/openapi/customdomain-ai-billing-api-openapi.yml
- **Documentation** — https://docs.customdomain.ai/docs/api-reference
- **JSONSchema** — https://artifacts.apis.io/customdomain-ai/json-schema/customdomain-ai-usage-schema.json
- **JSONSchema** — https://artifacts.apis.io/customdomain-ai/json-schema/customdomain-ai-billing-status-schema.json
- **JSONSchema** — https://artifacts.apis.io/customdomain-ai/json-schema/customdomain-ai-billing-notice-schema.json
- **JSONSchema** — https://artifacts.apis.io/customdomain-ai/json-schema/customdomain-ai-billing-standing-schema.json
- **JSONSchema** — https://artifacts.apis.io/customdomain-ai/json-schema/customdomain-ai-plan-schema.json
- **JSONSchema** — https://artifacts.apis.io/customdomain-ai/json-schema/customdomain-ai-billing-state-schema.json

## Other CustomDomain APIs (12)

- [CustomDomain MCP Server](https://apis.io/apis/customdomain-ai/mcp-server/)
- [CustomDomain Agents API](https://apis.io/apis/customdomain-ai/customdomain-ai-agents-api/)
- [CustomDomain Analytics API](https://apis.io/apis/customdomain-ai/customdomain-ai-analytics-api/)
- [CustomDomain Applications API](https://apis.io/apis/customdomain-ai/customdomain-ai-applications-api/)
- [CustomDomain Cloud browser API](https://apis.io/apis/customdomain-ai/customdomain-ai-cloud-browser-api/)
- [CustomDomain Connect API](https://apis.io/apis/customdomain-ai/customdomain-ai-connect-api/)
- [CustomDomain Connections API](https://apis.io/apis/customdomain-ai/customdomain-ai-connections-api/)
- [CustomDomain Domains API](https://apis.io/apis/customdomain-ai/customdomain-ai-domains-api/)
- [CustomDomain Enterprise API](https://apis.io/apis/customdomain-ai/customdomain-ai-enterprise-api/)
- [CustomDomain Managed DNS API](https://apis.io/apis/customdomain-ai/customdomain-ai-managed-dns-api/)
- [CustomDomain Members API](https://apis.io/apis/customdomain-ai/customdomain-ai-members-api/)
- [CustomDomain Meta API](https://apis.io/apis/customdomain-ai/customdomain-ai-meta-api/)

## Tags

Billing

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/customdomain-ai/customdomain-ai-billing-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/customdomain-ai/.