Skip to main content
July 20, 2026
Solved

List subscription API

  • July 20, 2026
  • 4 replies
  • 315 views

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

ahegdeAuthor
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
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.


 

 

ahegdeAuthor
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
Michael BAnswer
Lucid product team
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.