> 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/queries/promotional-offers.md).

# promotionalOffers

Historical issued offers, optionally filtered by offer definition and event. Use the same offer filters on subscriptions for distinct subscription cohorts. No offers are issued by this query.

### Arguments

| Argument                                                                                            | Description                                                                                 |
| --------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
| offerDefinitionId ([ID](/graphql-api/api-reference/objects/id.md))                                  | Filter by a configured offer, including archived offers.                                    |
| offerEvent ([PromotionalOfferEvent](/graphql-api/api-reference/objects/promotional-offer-event.md)) | Filter by a historical event on that offer. Requires offerDefinitionId; defaults to ISSUED. |
| offerEventSince ([ISO8601DateTime](/graphql-api/api-reference/objects/iso-8601-date-time.md))       | Inclusive start for the offer event timestamp. Requires offerDefinitionId and offerEvent.   |
| offerEventUntil ([ISO8601DateTime](/graphql-api/api-reference/objects/iso-8601-date-time.md))       | Exclusive end for the offer event timestamp. Requires offerDefinitionId and offerEvent.     |
| subscriptionId ([ID](/graphql-api/api-reference/objects/id.md))                                     | Restrict history to one subscription.                                                       |
| after ([String](/graphql-api/api-reference/objects/string.md))                                      | Returns the elements in the list that come after the specified cursor.                      |
| before ([String](/graphql-api/api-reference/objects/string.md))                                     | Returns the elements in the list that come before the specified cursor.                     |
| first ([Int](/graphql-api/api-reference/objects/int.md))                                            | Returns the first *n* elements from the list.                                               |
| last ([Int](/graphql-api/api-reference/objects/int.md))                                             | Returns the last *n* elements from the list.                                                |