---
title: "Get exclusions"
method: GET
path: "/v25-10-beta/agentic-logic/exclusions"
tags: ["Agentic Logic"]
---

# Get exclusions

`GET /v25-10-beta/agentic-logic/exclusions`

## Request

- Base URL: `https://api.intelligems.io`
- URL: `https://api.intelligems.io/v25-10-beta/agentic-logic/exclusions`
- Auth: API key in header `intelligems-access-token`
- TypeScript: <https://skmtc.dev/intelligems/apis/intelligems-external-api-v25-10-beta/docs/v25-10-beta/agentic-logic/exclusions/get.ts> (a function with typed inputs; its response is checked against the schema)

```http
GET /v25-10-beta/agentic-logic/exclusions
```

Returns the organization's exclusion set as `{ exclusions }`. Use the `intelligems-access-token` header.

- `productIds` (string array) — Shopify product GIDs.
- `tags` (string array) — Exact product tags.
- `collections` (string array) — Shopify collection GIDs; their members are
  excluded.
- `vendors` (string array) — Exact vendor names.
- `lastUpdateTs` (number or null) — Last edit time in Unix epoch milliseconds;
  `null` when the organization has never saved exclusions, in which case
  every list is empty.

Use the `intelligems-access-token` header. The token selects the organization; do not send `orgId`. The organization must have Agentic Logic enabled.

**Rate Limit:** 50 requests per 30s window, refilling 25 tokens every 30s.

## Response `200`

OK

- object
  - `exclusions` object, required: The org's serve-time ban list, enforced by the broker on every result envelope. One row per org; edits are effective immediately (no republish). All ids are Shopify GIDs.
    - `productIds` string[], required: Products never to recommend (gid://shopify/Product/<n>).
    - `tags` string[], required: Product tags never to recommend.
    - `collections` string[], required: Collections whose members are never recommended (gid://shopify/Collection/<n>).
    - `vendors` string[], required: Vendors whose products are never recommended.
    - `lastUpdateTs` number, nullable, required: Last edit time, Unix epoch-ms; null when the org has never saved exclusions.

## Other responses

- `429`: Too Many Requests

---

[API](https://skmtc.dev/intelligems/apis/intelligems-external-api-v25-10-beta.md) - [All operations](https://skmtc.dev/intelligems/apis/intelligems-external-api-v25-10-beta/llms.txt) - [OpenAPI document](https://skmtc.dev/intelligems/apis/intelligems-external-api-v25-10-beta/revisions/7b769b2f90b1?raw)