KintsugiKintsugi

Get the organization's chargebee subscription

GET/billing

Returns the plan, subscription, customer, and payment method for the org selected by Organization-Id, Connection-Id, or Entity-Id. subscription, customer, and card are null when the org never checked out or Chargebee is degraded; hasBillingAccount and hasDefaultPaymentMethod tell the cases apart.

Authorization

Api-KeystringRequired

Your secret API key. Include it with every request.

Headers

Api-Versiondate

Release date, as YYYY-MM-DD. Defaults to 2026-07-21.

Organization-Idstring

Target organization id (Organization-Id selector).

Connection-Idstring

Target connection id; resolves to its organization.

Entity-Idstring

Platform entity id; resolves to a connection's organization.

Entity-Sourcestring

Optional source to disambiguate an Entity-Id.

Response

billingPlanPublicBillingPlanEnumRequired

The organization's plan.

Available options:FREEGROWTHPREMIUM
subscriptionIdstring

Chargebee subscription id, or null if unset.

subscriptionSubscription

The Chargebee subscription, or null if unset.

customerBillingCustomer

The Chargebee customer, or null if unset.

cardPaymentCard

Payment card on file, or null if none is set.

hasBillingAccountbooleanRequired

False only when the organization has no Chargebee subscription or customer at all (it never checked out or opened the portal). True otherwise, even if Chargebee could not be reached and the fields above read null.

hasDefaultPaymentMethodbooleanRequired

True when Chargebee reports a non-blank primary or card payment source id. False when the organization never checked out, when neither id is present, or when Chargebee is degraded. Raw ids never reach the wire.

200

Successful Response

400

The request was invalid.

401

Authentication failed or was missing.

404

The requested resource was not found.

422

Validation Error

cURL
GET /billing
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
Response
{
"billingPlan": "FREE",
"subscriptionId": "3f6c2b1e-8a4d-4c2e-9b1f-2d7e5a6c9f10",
"subscription": {
"id": "3f6c2b1e-8a4d-4c2e-9b1f-2d7e5a6c9f10",
"status": "FUTURE",
"currency": "AED",
"billingPeriod": 1,
"billingPeriodUnit": "billing period unit",
"currentTermStart": "2026-07-28T12:00:00Z",
"currentTermEnd": "2026-07-28T12:00:00Z",
"nextBillingAt": "2026-07-28T12:00:00Z",
"coupon": "coupon",
"items": [
{
"itemPriceId": "3f6c2b1e-8a4d-4c2e-9b1f-2d7e5a6c9f10",
"itemType": "item type",
"quantity": 2,
"unitPrice": "10.00",
"amount": "10.00"
}
]
},
"customer": {
"email": "jane.doe@example.com",
"billingAddress": {
"firstName": "Jane",
"lastName": "Doe",
"line1": "123 Main St",
"line2": "Suite 400",
"city": "San Francisco",
"state": "CA",
"stateCode": "CA",
"country": "US",
"zip": "94107"
}
},
"card": {
"maskedNumber": "**** 4242",
"brand": "brand",
"fundingType": "funding type",
"expiryMonth": 1,
"expiryYear": 1,
"status": "ACTIVE"
},
"hasBillingAccount": false,
"hasDefaultPaymentMethod": false
}
Get the organization's chargebee subscription (2026-07-21) | Kintsugi API Reference