> For the complete documentation index, see [llms.txt](https://developer.firmhouse.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.firmhouse.com/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription-with-utils.md). # Interface: FirmhouseSubscriptionWithUtils ## Properties | Property | Type | Description | Overrides | Inherited from | | ---------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `activatedAt` | `string` \| `null` | The date and time when the subscription was activated and billing started. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`activatedAt`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#activatedat) | | `activePlan` | [`FirmhousePlan`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-plan.md) \| `null` | Returns the plan the subscription is currently subscribed to. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`activePlan`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#activeplan) | | `address` | `string` \| `null` | The customer's full address line or just street. Can include houseNumber if not separately stored in houseNumber field. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`address`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#address) | | `amountForStartingSubscriptionCents` | `number` \| `null` | The amount that is due on checkout (in cents). | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`amountForStartingSubscriptionCents`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#amountforstartingsubscriptioncents) | | `appliedPromotions?` | [`FirmhouseAppliedPromotion`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-applied-promotion.md)\[] \| `null` | List of all applied promotions for this customer. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`appliedPromotions`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#appliedpromotions) | | `billToAddress` | `string` \| `null` | The customer's billing address address line or street. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`billToAddress`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#billtoaddress) | | `billToCity` | `string` \| `null` | The customer's billing address city or town. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`billToCity`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#billtocity) | | `billToCompanyName` | `string` \| `null` | The company name of the customer's billing address. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`billToCompanyName`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#billtocompanyname) | | `billToCountry` | `string` \| `null` | The customer's billing address country code (ISO3661). | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`billToCountry`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#billtocountry) | | `billToDistrict` | `string` \| `null` | The customer's billing address district. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`billToDistrict`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#billtodistrict) | | `billToFullAddress` | `string` \| `null` | The customer's billing address full address by combining address and house number. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`billToFullAddress`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#billtofulladdress) | | `billToFullName` | `string` \| `null` | The customer's billing address full name. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`billToFullName`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#billtofullname) | | `billToHouseNumber` | `string` \| `null` | The customer's billing address house, building, or appartment number. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`billToHouseNumber`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#billtohousenumber) | | `billToLastName` | `string` \| `null` | The customer's billing address last name. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`billToLastName`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#billtolastname) | | `billToName` | `string` \| `null` | The customer' billing address first name. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`billToName`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#billtoname) | | `billToPhoneNumber` | `string` \| `null` | The customer's billing address phone number (international format). | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`billToPhoneNumber`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#billtophonenumber) | | `billToSalutation` | `string` \| `null` | The customer's billing address salutation (mr,ms,mx). | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`billToSalutation`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#billtosalutation) | | `billToState` | `string` \| `null` | The customer's billing address state or province (ISO3661-2). | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`billToState`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#billtostate) | | `billToZipcode` | `string` \| `null` | The customer's billing address zip code or postal code. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`billToZipcode`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#billtozipcode) | | `cancellationStartedAt` | `string` \| `null` | The date and time when cancellation was initiated for the subscription (in case of two-step cancellation). | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`cancellationStartedAt`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#cancellationstartedat) | | `cancelledAt` | `string` \| `null` | The date and time when the subscription was cancelled. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`cancelledAt`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#cancelledat) | | `chargeDayOfTheMonth` | `number` \| `null` | The day of the month when the customer is charged. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`chargeDayOfTheMonth`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#chargedayofthemonth) | | `checkoutUrl` | `string` \| `null` | URL for the customers to complete their draft subscription. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`checkoutUrl`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#checkouturl) | | `city` | `string` \| `null` | The customer's city or town. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`city`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#city) | | `collectionCases?` | [`FirmhouseCollectionCase`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-collection-case.md)\[] | List of collection cases for this customer | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`collectionCases`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#collectioncases) | | `companyName` | `string` \| `null` | The customer's company name. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`companyName`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#companyname) | | `country` | `string` \| `null` | The customer's country code (ISO 3116) | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`country`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#country) | | `createdAt` | `string` \| `null` | The date and time when the subscription record was first created. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`createdAt`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#createdat) | | `currency` | `string` \| `null` | The currency used for this subscription | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`currency`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#currency) | | `customerId` | `string` \| `null` | The customer ID given by the selected payment provider | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`customerId`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#customerid) | | `customerReference` | `string` \| `null` | The field that can be used for your internal reference. For example, internal customer id. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`customerReference`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#customerreference) | | `dateOfBirth` | `string` \| `null` | The customer's date of birth | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`dateOfBirth`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#dateofbirth) | | `differentBillingAddress` | `boolean` \| `null` | Whether billing and shipping addresses are the same. Set this flag to `true` to store a separate billing address. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`differentBillingAddress`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#differentbillingaddress) | | `district` | `string` \| `null` | The customer's district | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`district`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#district) | | `email` | `string` \| `null` | The customer's email address | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`email`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#email) | | `extraFields` | [`FirmhouseExtraFieldAnswer`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-extra-field-answer.md)\[] | List of extra fields and values. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`extraFields`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#extrafields) | | `fullAddress` | `string` \| `null` | The customer's full address by combining address and house number. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`fullAddress`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#fulladdress) | | `fullName` | `string` \| `null` | The customer's full name. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`fullName`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#fullname) | | `getClosestUpcomingOrderDate` | () => `string` \| `null` | Utilty to check the closest upcoming order date | - | [`FirmhouseSubscriptionUtils`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription-utils.md).[`getClosestUpcomingOrderDate`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription-utils.md#getclosestupcomingorderdate) | | `getClosestUpcomingOrderOrderedProducts` | () => [`FirmhouseOrderedProduct`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-ordered-product.md)\[] | Utility to check the closest upcoming order ordered products | - | [`FirmhouseSubscriptionUtils`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription-utils.md).[`getClosestUpcomingOrderOrderedProducts`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription-utils.md#getclosestupcomingorderorderedproducts) | | `houseNumber` | `string` \| `null` | The customer's house number. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`houseNumber`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#housenumber) | | `id` | `string` \| `null` | The id of the subscription. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`id`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#id) | | `identityVerificationUrl` | `string` \| `null` | Identity verification URL that automatically uses the configured provider.Append ?return\_url= to send the customer back after a successful identification. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`identityVerificationUrl`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#identityverificationurl) | | `inTrialPeriod` | `boolean` | Whether this subscription is currently in its trial period. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`inTrialPeriod`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#intrialperiod) | | `invoices?` | [`FirmhouseInvoice`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-invoice.md)\[] \| `null` | List of invoices of this customer. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`invoices`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#invoices) | | `lastName` | `string` \| `null` | The customer's last name. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`lastName`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#lastname) | | `locale` | `string` \| `null` | The customer's locale/language. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`locale`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#locale) | | `markedAsNonPayingAt` | `string` \| `null` | The date and time when the subscription was last marked as non-paying. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`markedAsNonPayingAt`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#markedasnonpayingat) | | `marketingOptIn` | `boolean` \| `null` | Whether the customer accepted the optional marketing opt-in. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`marketingOptIn`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#marketingoptin) | | `metadata` | `unknown` | Metadata makes it possible to store additional information on objects. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`metadata`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#metadata) | | `monthlyAmountCents` | `number` \| `null` | The monthly amount that is charged. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`monthlyAmountCents`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#monthlyamountcents) | | `name` | `string` \| `null` | The customer's first name. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`name`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#name) | | `notes` | `string` \| `null` | Notes about the customer that can be set in the portal | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`notes`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#notes) | | `orderedProducts` | \| [`FirmhouseOrderedProductWithUtils`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-ordered-product-with-utils.md)\[] \| `null` | The ordered products that are part of the order | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`orderedProducts`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#orderedproducts) | - | | `ordersV2?` | [`PaginatedResponse`](/sdks/firmhouse-sdk/reference/typealiases/paginated-response.md)<[`FirmhouseOrder`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-order.md)> | List of orders of this subscription | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`ordersV2`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#ordersv2) | | `paidAmount` | `number` \| `null` | The amount that is succesfully paid so far. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`paidAmount`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#paidamount) | | `pausedAt` | `string` \| `null` | The time the subscription was paused. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`pausedAt`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#pausedat) | | `pausedUntil` | `string` \| `null` | The time the subscription will be automatically resumed. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`pausedUntil`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#pauseduntil) | | `paymentMethod` | `string` \| `null` | The payment method currently in use for billing | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`paymentMethod`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#paymentmethod) | | `paymentMethodSummary` | `string` \| `null` | The last 4 digits of the current payment method. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`paymentMethodSummary`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#paymentmethodsummary) | | `paymentMethodTranslated` | `string` \| `null` | Localised string of the payment method currently in use for billing. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`paymentMethodTranslated`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#paymentmethodtranslated) | | `phoneNumber` | `string` \| `null` | The customer's full international phone number | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`phoneNumber`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#phonenumber) | | `pspPaymentMethodDetails` | `unknown` | The payment method details returned by PSP currently used for billing. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`pspPaymentMethodDetails`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#psppaymentmethoddetails) | | `salutation` | `string` \| `null` | The customer's salutation (mr,ms,mx). | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`salutation`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#salutation) | | `signupCompletedAt` | `string` \| `null` | The date and time when the subscription completed their signup and made their initial payment (or no payment if free). | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`signupCompletedAt`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#signupcompletedat) | | `skipAutoActivationOnSignup` | `boolean` | If true then the subscription won't be activated after signup and initial payment. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`skipAutoActivationOnSignup`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#skipautoactivationonsignup) | | `startDate` | `string` | The date and time when this subscription was (or will be) charged for the first time. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`startDate`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#startdate) | | `state` | `string` \| `null` | The customer's state | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`state`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#state) | | `status` | [`SubscriptionStatus`](/sdks/firmhouse-sdk/reference/enumerations/subscription-status.md) | Status of this customer. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`status`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#status) | | `stoppedAt` | `string` \| `null` | The date and time when the subscription was automatically stopped. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`stoppedAt`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#stoppedat) | | `subscribedPlan` | [`FirmhouseSubscribedPlan`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscribed-plan.md) \| `null` | Returns the plan relationship and contract terms of the current plan | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`subscribedPlan`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#subscribedplan) | | `termsAccepted` | `boolean` | Whether the customer accepted the terms and conditions. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`termsAccepted`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#termsaccepted) | | `termsAcceptedOn` | `string` \| `null` | Whether the customer has accepted the terms\&conditions. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`termsAcceptedOn`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#termsacceptedon) | | `token` | `string` | Unique token of the subscription | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`token`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#token) | | `trialPeriodMonths` | `number` \| `null` | The number of months before customer is charged for the first time. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`trialPeriodMonths`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#trialperiodmonths) | | `updatedAt` | `string` \| `null` | The date and time when the subscription was last updated. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`updatedAt`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#updatedat) | | `updatePaymentMethodUrl` | `string` \| `null` | Send your customer to this URL to allow them to update their active payment method. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`updatePaymentMethodUrl`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#updatepaymentmethodurl) | | `vatNumber` | `string` \| `null` | The company's VAT number. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`vatNumber`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#vatnumber) | | `verifiedIdentity?` | [`FirmhouseVerifiedIdentity`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-verified-identity.md) \| `null` | Details of the verified identity if present. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`verifiedIdentity`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#verifiedidentity) | | `zipcode` | `string` \| `null` | The customer's postal code or zipcode. | - | [`FirmhouseSubscription`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md).[`zipcode`](/sdks/firmhouse-sdk/reference/interfaces/firmhouse-subscription.md#zipcode) |