License Fee Subscriptions v2

A License Fee Subscription links one License Fee to a specific Billing Cadence. While the License Fee Subscription is active, Stripe will bill the payer according to the License Fee’s pricing and the quantity subscribed.

The LicenseFeeSubscription object 

Attributes

  • idstring

    Unique identifier for the object.

  • objectstring, value is "v2.billing.license_fee_subscription"

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

  • billing_cadencestring

    The ID of the Billing Cadence.

  • createdtimestamp

    Timestamp of when the object was created.

  • license_feestring

    The ID of the License Fee.

  • license_fee_versionstring

    The ID of the License Fee Version.

  • livemodeboolean

    Has the value true if the object exists in live mode or the value false if the object exists in test mode.

  • metadatanullable map

    Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.

  • quantityinteger

    Quantity of the License Fee subscribed to.

  • test_clocknullable string

    The ID of the Test Clock, if any.

The LicenseFeeSubscription object
{
"billing_cadence": "bc_61SahwKGATwuyXMY516SBbsMNLSQJnWcho4VDz0fYLKi",
"created": "2025-01-01T00:00:00.000Z",
"id": "lfs_61Sai6XI0UDAyOhhh16SBbsMNLSQJnWcho4VDz0fYMIS",
"license_fee": "licf_61SahqwY8y4J62hb416SBbsMNLSQJnWcho4VDz0fY2Rc",
"license_fee_version": "licfv_61SahqwswB6xPIPuo16SBbsMNLSQJnWcho4VDz0fYTYW",
"metadata": {},
"object": "v2.billing.license_fee_subscription",
"quantity": 1,
"test_clock": null,
"livemode": true
}

Retrieve a License Fee Subscription v2

Retrieve a License Fee Subscription object.

Learn more about calling API v2 endpoints.

Parameters

  • idstringRequired

    The ID of the License Fee Subscription to retrieve.

Returns

Response attributes

  • idstring

    Unique identifier for the object.

  • objectstring, value is "v2.billing.license_fee_subscription"

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

  • billing_cadencestring

    The ID of the Billing Cadence.

  • createdtimestamp

    Timestamp of when the object was created.

  • license_feestring

    The ID of the License Fee.

  • license_fee_versionstring

    The ID of the License Fee Version.

  • livemodeboolean

    Has the value true if the object exists in live mode or the value false if the object exists in test mode.

  • metadatanullable map

    Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.

  • quantityinteger

    Quantity of the License Fee subscribed to.

  • test_clocknullable string

    The ID of the Test Clock, if any.

Error Codes
404license_fee_subscription_not_found

Returned when the requested License Fee Subscription cannot be found.

GET /v2/billing/license_fee_subscriptions/:id
curl https://api.stripe.com/v2/billing/license_fee_subscriptions/lfs_61Sai6XI0UDAyOhhh16SBbsMNLSQJnWcho4VDz0fYMIS \
-H "Authorization: Bearer sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2" \
-H "Stripe-Version: 2025-08-27.preview"
Response
{
"billing_cadence": "bc_61SahwKGATwuyXMY516SBbsMNLSQJnWcho4VDz0fYLKi",
"created": "2025-01-01T00:00:00.000Z",
"id": "lfs_61Sai6XI0UDAyOhhh16SBbsMNLSQJnWcho4VDz0fYMIS",
"license_fee": "licf_61SahqwY8y4J62hb416SBbsMNLSQJnWcho4VDz0fY2Rc",
"license_fee_version": "licfv_61SahqwswB6xPIPuo16SBbsMNLSQJnWcho4VDz0fYTYW",
"metadata": {},
"object": "v2.billing.license_fee_subscription",
"quantity": 1,
"test_clock": null,
"livemode": true
}

Metered Items v2

A Metered Item represents any item that you bill customers for based on how much they use it, such as hourly cloud CPU usage or tokens generated by an AI service.