> 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/graphql-api/api-reference/objects/promotional-offer.md).

# PromotionalOffer

A configured promotional offer issued to a specific subscription.

### Fields

#### acceptUrl ([String](/graphql-api/api-reference/objects/string.md)!)

The plain public page URL where an authenticated customer can review and accept the offer.

#### acceptedAt ([ISO8601DateTime](/graphql-api/api-reference/objects/iso-8601-date-time.md))

When acceptance succeeded.

#### benefit ([JSON](/graphql-api/api-reference/objects/json.md)!)

The benefit saved when this offer was issued.

#### cancelledAt ([ISO8601DateTime](/graphql-api/api-reference/objects/iso-8601-date-time.md))

When the system cancelled the offer.

#### commitment ([JSON](/graphql-api/api-reference/objects/json.md))

The optional commitment saved at issuance.

#### createdAt ([ISO8601DateTime](/graphql-api/api-reference/objects/iso-8601-date-time.md)!)

When this offer instance was persisted.

#### definitionRevision ([Int](/graphql-api/api-reference/objects/int.md)!)

The configuration revision saved at issuance.

#### entryPoint ([String](/graphql-api/api-reference/objects/string.md)!)

The entry point recorded at issuance.

#### expiresAt ([ISO8601DateTime](/graphql-api/api-reference/objects/iso-8601-date-time.md)!)

When the offer expires.

#### id ([ID](/graphql-api/api-reference/objects/id.md)!)

The database ID of the issued offer.

#### offerDefinition ([OfferDefinition](/graphql-api/api-reference/objects/offer-definition.md)!)

The configuration that issued this offer.

#### rejectedAt ([ISO8601DateTime](/graphql-api/api-reference/objects/iso-8601-date-time.md))

When the offer was declined, including choosing another cancellation action.

#### status ([PromotionalOfferStatus](/graphql-api/api-reference/objects/promotional-offer-status.md)!)

Whether the offer is pending, accepted, rejected, or cancelled.

#### subscriptionId ([ID](/graphql-api/api-reference/objects/id.md)!)

The subscription that received this offer.

#### viewedAt ([ISO8601DateTime](/graphql-api/api-reference/objects/iso-8601-date-time.md))

First recorded view. Historical tracking excludes some portal presentations.