> ## 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 per-buyer auto-approvals

> Read every per-buyer media-buy auto-approve override on the storefront

`GET /api/v2/storefront/buyer-auto-approvals`

Returns the per-buyer media-buy auto-approve overrides on your storefront —
**both** enabled and disabled rows, enabled first — plus every transacting buyer
eligible for a new override. Buyer names are resolved for confirmation. The
storefront is resolved from your authenticated identity.

Reach for this after tightening your storefront back to `mediaBuyApproval: manual`,
to confirm which trusted-buyer carve-outs are still live (overrides survive an
`auto` → `manual` flip).

## Request

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

## Response

```json theme={null}
{
  "items": [
    {
      "id": "42",
      "storefrontId": "1234",
      "buyerCustomerId": 804,
      "buyerName": "Coca-Cola",
      "autoApproveEnabled": true,
      "reason": "Coke — pre-cleared 2026 always-on.",
      "createdAt": "2026-06-28T15:00:00.000Z",
      "updatedAt": "2026-06-28T15:00:00.000Z",
      "createdBy": "11",
      "createdByCustomerId": 1234,
      "updatedByCustomerId": 1234,
      "policyBypassCount": 2,
      "lastPolicyBypassAt": "2026-06-29T09:00:00.000Z"
    }
  ],
  "total": 1,
  "eligibleBuyers": [
    {
      "buyerCustomerId": 804,
      "buyerName": "Coca-Cola",
      "mediaBuyCount": 12,
      "lastMediaBuyAt": "2026-06-29T09:00:00.000Z"
    }
  ]
}
```

`policyBypassCount` is how many of this buyer's auto-forwarded media buys your
acceptance policy *would* have held (the buy still forwarded — this only records
it). A non-zero count is a prompt to revisit the carve-out — see
[Watching the trust](/v2/storefront/buyer-auto-approvals/overview#watching-the-trust).

`eligibleBuyers` is derived only from media buys submitted to this storefront,
so it is safe to use as the selection list for a new override. It includes
buyers with enabled or disabled rows so clients can reconcile the complete
trust roster.

Returns `200`. `total` is the number of override rows returned.

## Errors

* `404 NOT_FOUND` — no storefront exists for the caller.
* `401 UNAUTHORIZED` — missing or invalid bearer token.

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

## Related

<CardGroup cols={2}>
  <Card title="Set per-buyer auto-approve" href="/v2/storefront/buyer-auto-approvals/tasks/set-buyer-auto-approval" icon="user-check">
    Enable or disable auto-approve for one buyer.
  </Card>

  <Card title="Per-buyer auto-approve" href="/v2/storefront/buyer-auto-approvals/overview" icon="user-check">
    What the override does, and what it deliberately doesn't.
  </Card>
</CardGroup>