> ## Documentation Index
> Fetch the complete documentation index at: https://aiodapp.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Discount performance

> shopify_discount_performance reports one AIOD discount's orders, revenue, margin given away, and revenue over time.

Reports what one discount earned over a date range.

<Info>
  **Tool name:** `shopify_discount_performance` · **Previously:** `get_discount_performance` · **Read-only**
</Info>

## When to use it

This is what answers "is this promotion working?", "how much has the BOGO made?", "did the free shipping threshold lift average order value?", and "which discounts are worth running again for Black Friday?"

To compare offers, call it **once per discount**. There is no all-at-once version.

## Parameters

| Name        | Type   | Required | What it does                                                                  |
| ----------- | ------ | -------- | ----------------------------------------------------------------------------- |
| `id`        | string | **Yes**  | A discount id from [Find discounts](/docs/mcp-server/tools/shopify-discount-find). |
| `startDate` | string | No       | Inclusive, `YYYY-MM-DD`. Defaults to the AIOD dashboard's usual window.       |
| `endDate`   | string | No       | Inclusive, `YYYY-MM-DD`. Defaults to the AIOD dashboard's usual window.       |

## What comes back

```json theme={null}
{
  "id": "clx8n2k9a0001abcd",
  "title": "Summer BOGO — tees",
  "status": "ACTIVE",
  "startDate": "2026-06-01",
  "endDate": "2026-06-30",
  "orderCount": 214,
  "influencedRevenue": 18420.5,
  "totalDiscountValue": 2610.75,
  "averageOrderValue": 86.08,
  "currencyCode": "USD",
  "revenueOverTime": [{ "date": "2026-06-01", "revenue": 612.4 }],
  "note": null
}
```

| Field                | What it is                                                                                            |
| -------------------- | ----------------------------------------------------------------------------------------------------- |
| `orderCount`         | Orders attributed to this discount in the range.                                                      |
| `influencedRevenue`  | Total revenue of those orders.                                                                        |
| `totalDiscountValue` | The margin the discount gave away.                                                                    |
| `averageOrderValue`  | Revenue divided by orders, or `0` when there are none.                                                |
| `currencyCode`       | The currency for every figure here.                                                                   |
| `revenueOverTime`    | A chart series, at a granularity picked from the length of the range. Empty when there are no orders. |
| `note`               | Only set when `orderCount` is `0`, explaining why.                                                    |

These are the same figures as the in-app [Analytics](/docs/app/analytics) tab, so an assistant's numbers and the dashboard's numbers agree.

## Errors

| Status | Body                                |
| ------ | ----------------------------------- |
| `400`  | `{ "error": "Missing id" }`         |
| `404`  | `{ "error": "Discount not found" }` |

## Things people ask that land here

* "How is my BOGO performing this month?"
* "Compare the free gift offer and the volume discount for June."
* "How much margin did the sitewide 20% give away?"
* "Which promotion should I re-run for Black Friday?"

## Limits

* **Totals only.** No orders, no line items, no customer records.
* **One discount at a time.** Store-wide sales, sessions, and discounts AIOD doesn't manage are out of scope.
* **Zero orders on a new discount is normal.** Attribution lags checkout by a short while, and `note` says so. Report the zero with that caveat rather than calling the discount broken.