> 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-billing-cycle-promotion.md).

# Interface: FirmhouseBillingCyclePromotion

## Properties

| Property                                 | Type                                                                                                                                                           | Description                                                         | Inherited from                                                                                                                                                                                                                                                                                                                  |
| ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `active`                                 | `boolean`                                                                                                                                                      | Whether or not this promotion is currently active                   | [`FirmhouseAppliedPromotion`](https://developer.firmhouse.com/sdks/firmhouse-sdk/reference/interfaces/firmhouse-applied-promotion.md).[`active`](https://developer.firmhouse.com/sdks/firmhouse-sdk/reference/interfaces/firmhouse-applied-promotion.md#active)                                                                 |
| `amountUsedIncludingTaxCents`            | `number`                                                                                                                                                       | Total amount used, only relevant for promotions with monetary limit | [`FirmhouseAppliedPromotion`](https://developer.firmhouse.com/sdks/firmhouse-sdk/reference/interfaces/firmhouse-applied-promotion.md).[`amountUsedIncludingTaxCents`](https://developer.firmhouse.com/sdks/firmhouse-sdk/reference/interfaces/firmhouse-applied-promotion.md#amountusedincludingtaxcents)                       |
| `deactivateAfterAmountIncludingTaxCents` | `number` \| `null`                                                                                                                                             | Total amount used, only relevant for promotions with monetary limit | [`FirmhouseAppliedPromotion`](https://developer.firmhouse.com/sdks/firmhouse-sdk/reference/interfaces/firmhouse-applied-promotion.md).[`deactivateAfterAmountIncludingTaxCents`](https://developer.firmhouse.com/sdks/firmhouse-sdk/reference/interfaces/firmhouse-applied-promotion.md#deactivateafteramountincludingtaxcents) |
| `deactivateAfterTimes`                   | `number` \| `null`                                                                                                                                             | After how many times this promotion is "used up" for a customer     | [`FirmhouseAppliedPromotion`](https://developer.firmhouse.com/sdks/firmhouse-sdk/reference/interfaces/firmhouse-applied-promotion.md).[`deactivateAfterTimes`](https://developer.firmhouse.com/sdks/firmhouse-sdk/reference/interfaces/firmhouse-applied-promotion.md#deactivateaftertimes)                                     |
| `deactivationStrategy`                   | [`AppliedPromotionDeactivationStrategy`](https://developer.firmhouse.com/sdks/firmhouse-sdk/reference/enumerations/applied-promotion-deactivation-strategy.md) | Which mechanism will be used to deactivate the applied promotion    | [`FirmhouseAppliedPromotion`](https://developer.firmhouse.com/sdks/firmhouse-sdk/reference/interfaces/firmhouse-applied-promotion.md).[`deactivationStrategy`](https://developer.firmhouse.com/sdks/firmhouse-sdk/reference/interfaces/firmhouse-applied-promotion.md#deactivationstrategy)                                     |
| `discountCode?`                          | [`FirmhouseDiscountCode`](https://developer.firmhouse.com/sdks/firmhouse-sdk/reference/interfaces/firmhouse-discount-code.md) \| `null`                        | The discount code that applied this promotion, when present.        | [`FirmhouseAppliedPromotion`](https://developer.firmhouse.com/sdks/firmhouse-sdk/reference/interfaces/firmhouse-applied-promotion.md).[`discountCode`](https://developer.firmhouse.com/sdks/firmhouse-sdk/reference/interfaces/firmhouse-applied-promotion.md#discountcode)                                                     |
| `id`                                     | `string`                                                                                                                                                       | ID to identify the applied promotion with                           | [`FirmhouseAppliedPromotion`](https://developer.firmhouse.com/sdks/firmhouse-sdk/reference/interfaces/firmhouse-applied-promotion.md).[`id`](https://developer.firmhouse.com/sdks/firmhouse-sdk/reference/interfaces/firmhouse-applied-promotion.md#id)                                                                         |
| `invoices?`                              | [`FirmhouseInvoice`](https://developer.firmhouse.com/sdks/firmhouse-sdk/reference/interfaces/firmhouse-invoice.md)\[]                                          | Invoices on which this promotion was applied.                       | -                                                                                                                                                                                                                                                                                                                               |
| `promotion`                              | [`FirmhousePromotion`](https://developer.firmhouse.com/sdks/firmhouse-sdk/reference/interfaces/firmhouse-promotion.md)                                         | The associated promotion                                            | [`FirmhouseAppliedPromotion`](https://developer.firmhouse.com/sdks/firmhouse-sdk/reference/interfaces/firmhouse-applied-promotion.md).[`promotion`](https://developer.firmhouse.com/sdks/firmhouse-sdk/reference/interfaces/firmhouse-applied-promotion.md#promotion)                                                           |
| `timesUsed`                              | `number`                                                                                                                                                       | The amount of times this applied promotion has been used.           | [`FirmhouseAppliedPromotion`](https://developer.firmhouse.com/sdks/firmhouse-sdk/reference/interfaces/firmhouse-applied-promotion.md).[`timesUsed`](https://developer.firmhouse.com/sdks/firmhouse-sdk/reference/interfaces/firmhouse-applied-promotion.md#timesused)                                                           |
