v13

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-08-04237161688.6 KB
Organizations
Billing

Retrieve an organization's billing subscription

Retrieves the billing subscription for the specified organization. This includes subscription details, active plans, billing information, and payment status. The subscription contains subscription items which represent the individual plans the organization is subscribed to.

get/organizations/{organization_id}/billing/subscription

Path parameters

organization_idstring required

The ID of the organization whose subscription to retrieve

Response

A commerce subscription.

object'commerce_subscription' required

String representing the object's type. Objects of the same type share the same value.

idstring required

Unique identifier for the commerce subscription.

instance_idstring required

The ID of the instance this subscription belongs to.

status'active' | 'past_due' | 'canceled' | 'ended' | 'abandoned' | 'incomplete' required

The current status of the subscription.

payer_idstring required

The ID of the payer for this subscription.

created_atinteger required

Unix timestamp (milliseconds) of creation.

updated_atinteger required

Unix timestamp (milliseconds) of last update.

active_atinteger nullable required

Unix timestamp (milliseconds) when the subscription became active.

past_due_atinteger nullable required

Unix timestamp (milliseconds) when the subscription became past due.

eligible_for_free_trialboolean

Whether the payer is eligible for a free trial.