> ## 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.

# Find discounts

> shopify_discount_find lists the AIOD discounts on your Shopify store and returns the id every other tool needs.

Lists the discounts AIOD is running on the store.

<Info>
  **Tool name:** `shopify_discount_find` · **Previously:** `find_discounts` · **Read-only**
</Info>

## When to use it

Whenever someone refers to a discount in words rather than by id — "my summer BOGO", "the free gift offer", "the 10% off tees".

**Start here.** Every other store tool needs the `id` this returns, and there is nowhere else to get one.

It gives you setup and status only. For the money, use [Discount performance](/docs/mcp-server/tools/shopify-discount-performance). For the full rule, use [Read a discount](/docs/mcp-server/tools/shopify-discount-get).

## Parameters

| Name    | Type    | Required | What it does                                                                  |
| ------- | ------- | -------- | ----------------------------------------------------------------------------- |
| `query` | string  | No       | Filters by name, case-insensitive substring. Leave it out to list everything. |
| `first` | integer | No       | How many to return. Defaults to `10`, capped at `50`.                         |

<Tip>
  Usually, don't pass `query`. A merchant's "my summer sale" rarely matches the stored "Summer 2026 — 20% sitewide", so filtering returns nothing while listing everything lets you match on meaning.
</Tip>

## What comes back

```json theme={null}
{
  "results": [
    {
      "id": "clx8n2k9a0001abcd",
      "title": "Summer BOGO — tees",
      "status": "ACTIVE",
      "discountType": "automatic",
      "template": "bxgy",
      "editUrl": "https://admin.shopify.com/store/your-store/apps/aiod-automatic-discounts/app/bogo/clx8n2k9a0001abcd"
    }
  ],
  "pageInfo": { "hasNextPage": false, "hasPreviousPage": false }
}
```

| Field          | What it is                                                                             |
| -------------- | -------------------------------------------------------------------------------------- |
| `id`           | The AIOD discount id. This is what every other tool wants. Not a Shopify GID.          |
| `title`        | The discount's display name.                                                           |
| `status`       | Active, draft, or test mode.                                                           |
| `discountType` | `automatic`, `gift`, `shipping`, or `tiered`.                                          |
| `template`     | Which AIOD template it was built from.                                                 |
| `editUrl`      | A link straight into the AIOD editor in the Shopify admin. Safe to hand to a merchant. |

Newest first. The underlying scan is bounded, so a store with a very large number of discounts may not have every single one represented — narrow with `query` if that happens.

## Things people ask that land here

* "What discounts are running right now?"
* "Do I have a free gift offer live?"
* "Find my Black Friday discount."
* "List everything and tell me which ones expire this month."

## Limits

* Covers only the automatic discounts AIOD manages. Discount codes, and discounts created directly in Shopify or by another app, are not included.
* Reads no orders, products, or customers.
* Reaches exactly one store — the one that was approved when the connector was set up.