Sign in

v13

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

Retrieve a user's billing subscription

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

get/users/{user_id}/billing/subscription

Path parameters

user_idstring required

The ID of the user 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.