# Promotions \[IN DEV]

{% hint style="danger" %}
This capability is currently being developed by the working group and has not yet undergone Specification Committee Review, Member Review, and Public Review phases before ratification.

OCTO members interested in joining the working group can find details in the **#promotions-capability-development** channel in the OCTO Slack workspace.

This page provides draft materials and ongoing updates from the working group, all of which remain subject to change throughout the review process.
{% endhint %}

### Business Context

Promotional (or discounted) pricing is a fundamental part of how tour and activity suppliers and resellers attract customers, drive conversions, and run marketing campaigns.

This extends the [Pricing Capability](https://docs.octo.travel/capabilities-optional/pricing) by allowing supplier systems to expose structured promotional offers to reseller systems during availability and pricing requests, and throughout the entire booking flow. 

This capability only covers price-based discounts (i.e., reductions to retail or net prices). More complex constructs, such as product bundling, will be defined under a separate capability.

The Promotions Capability requires the use of [Pricing Capability](https://docs.octo.travel/capabilities-optional/pricing). The additional fields provided through this capability describe promotional details associated with pricing, clarifying which discounts are available and/or have been applied. 

This supports both open promotions and gated offers such as member-only pricing, loyalty discounts, and promo codes.

### Working Draft:

<https://docs.google.com/document/d/18n_FmBM3T-BRwdRKW1D3d6dRqNuJFOeP6Z1q4ebYb90/edit?usp=sharing>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.octo.travel/capabilities-optional/promotions-in-dev.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.