Subscriptions

Subscription is an arrangement to receive goods or services regularly by paying in advance.

Data Model

FieldTypeDescriptionExample data
idstringUnique Identifier for each subscription.56879
metaIdstringId of this subscription in its origin data source (when it comes from an integration).sub_3245
codestringUnique code identifies the subscription (rather than using the random id field generated for each entry in our database)YWM_SUB
parentIdstringIf multiple records represent the same subscription (coming from different data sources, for example), you can choose one subscription to represent all of them and call it a parent, then assign this Id as parentId to the other subscriptions.34599
customerIdstringUnique identifier for the customer who made this subscription.609987152
metaCustomerIdstringId of the customer who made this subscription in its origin data source (when it comes from an integration).cus_KJX33C2
currencyIdstringCurrency Id of this payment.3168
metaCurrencyIdstringCurrency Id of this payment in its origin data source (when it comes from an integration).EUR
mainProductIdstringProduct Id.8652
metaMainProductIdstringProduct Id of this subscription in its origin data source (when it comes from an integration).prod_3402
statusstringSubscription status (Options: active, past_due, unpaid, canceled, incomplete, expired, trialing, future, detected, draft, pending_activation, pending_acceptance, suspended, pending).pending_activation
originIdstringSubscriptions can be synced from subscriprion software or detected from invoices with recurring products. If the subscription is detected then its dataSourceId will be your default (manual) one. So, originId is the dataSourceId of the synced invoices that is detected from this subscription.3214
start_datestringSubscription start date.2022-02-02T14:13:53.644Z
endDatestringSubscription end date.2022-02-02T14:13:53.644Z
billingPeriodstringBilling period (Options: day, week, month, quarter, year, custom).month
billingFrequencynumberBilling frequency.1
renewalProbabilitynumberRenewal probability estimation as percentage from 0 to 100.75
dataSourceIdstringId of the data source (Manual Calqulate, or integrations).4779
orgIdstringOrganization Id in which this subscription belongs.718987154
createdAtstring (ISO-8601 Date)Date of creation of this entry in Calqulate's Database.2022-02-02T14:13:53.644Z
updatedAtstring (ISO-8601 Date)Date of last update done on this entry in Calqulate's Database.2022-02-02T14:13:53.644Z
deletedAtstring (ISO-8601 Date)Date of deletion of this entry from Calqulate's Database.2022-02-02T14:13:53.644Z