Skip to main content
Solved

List subscription API

  • July 20, 2026
  • 4 replies
  • 253 views

Forum|alt.badge.img+3

Hi Lucid community!

I had a question regarding the response from the List Subscriptions API.

The developer documentation mentions that the API returns a Subscription ID. Could someone clarify whether this ID is:

  • Fixed across all accounts for a given plan, or
  • Specific to each customer account?

For example, would all customers on the Teams Licensing Plan have the same Subscription ID, or would each customer have a unique Subscription ID for that plan?

Could someone please clarify how this works? Thanks!

Best answer by Michael B

When a Plan is applied to an account, a `subscription` is the unique identifier to that account’s specific implementation of the plan as of the moment it was applied. 

This allows the details of a Plan to evolve over time without necessarily affecting everyone on the plan. Lets say that tomorrow we wanted to make a modification to an existing plan, we could do so without affecting anyone already on the plan.

Technically, no account is on a Plan. They are on a subscription which is pointer to a Plan. So, a Plan can have many subscriptions in the sense that each subscription is an instance of that Plan.

I do not think a single account could have multiple subscriptions that represent the same Plan. At least, not under any typical scenario. 

Comments

Forum|alt.badge.img+3
  • Author
  • July 22, 2026

Also we would like to know the relation between Plan name with subscription ID (ex. 1:1 or 1:N)


Michael B
Forum|alt.badge.img+4
  • Lucid product team
  • July 22, 2026

The subscriptionId is unique to a specific subscription on a customer’s Lucid account. It is not a shared Id for a particular plan, so two customers on the same Team plan will have different subscriptionIds. (1:N)

Subsciptions are an individual instance of a Plan. Plan information is currently not available via the Public API.


 

 


Forum|alt.badge.img+3
  • Author
  • July 23, 2026

Just to clarify the 1:N relationship—does that mean one Plan can have many Subscriptions? If yes, what do those individual subscriptions represent, and in what scenarios would multiple subscriptions exist for the same plan?


Michael B
Forum|alt.badge.img+4
  • Lucid product team
  • Answer
  • July 23, 2026

When a Plan is applied to an account, a `subscription` is the unique identifier to that account’s specific implementation of the plan as of the moment it was applied. 

This allows the details of a Plan to evolve over time without necessarily affecting everyone on the plan. Lets say that tomorrow we wanted to make a modification to an existing plan, we could do so without affecting anyone already on the plan.

Technically, no account is on a Plan. They are on a subscription which is pointer to a Plan. So, a Plan can have many subscriptions in the sense that each subscription is an instance of that Plan.

I do not think a single account could have multiple subscriptions that represent the same Plan. At least, not under any typical scenario.