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

# List house discounts

> Read every house discount on the storefront

`GET /api/v2/storefront/house-discounts`

Returns every house discount configured on the calling storefront, ordered by
house domain.

## Request

```bash curl theme={null}
curl https://api.interchange.io/api/v2/storefront/house-discounts \
  -H "Authorization: Bearer $SCOPE3_API_KEY"
```

## Response

```json theme={null}
{
  "items": [
    {
      "id": "17",
      "storefrontId": "1234",
      "houseDomain": "nike.com",
      "scope": "brand",
      "discountPercent": 12,
      "notes": "Negotiated 2026 Nike-house rate.",
      "createdAt": "2026-06-27T15:00:00.000Z",
      "updatedAt": "2026-06-27T15:00:00.000Z",
      "createdBy": "operator@touchline.example"
    }
  ],
  "total": 1
}
```

Returns `200`. The list is the full, hand-curated set for the storefront — there
is no pagination.

## Errors

* `401 UNAUTHORIZED` — missing or invalid bearer token.

See [Errors](/v2/reference/errors) for the full error contract.

## Related

<CardGroup cols={2}>
  <Card title="House discount tasks" href="/v2/storefront/house-discounts/tasks" icon="list-check">
    All house-discount operations.
  </Card>

  <Card title="Intelligence runs" href="/v2/storefront/intelligence-runs/overview" icon="microscope">
    See which discount was applied per discovery run.
  </Card>
</CardGroup>