---
title: "List AI Referrals Connections"
method: GET
path: "/{brand_id}/ai-referrals/connections"
tags: ["ai-referrals"]
---

# List AI Referrals Connections

`GET /{brand_id}/ai-referrals/connections`

## Request

- Base URL: `https://api.scrunchai.com/v1`
- URL: `https://api.scrunchai.com/v1/{brand_id}/ai-referrals/connections`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/scrunch/apis/scrunch-data-api/docs/:brand_id/ai-referrals/connections/get.ts> (a function with typed inputs; its response is checked against the schema)

List AI Referrals push connections registered for this brand. Scope is limited to push connections only — Google Analytics integrations live in a separate system and are not returned here, even though they can block a register call with `409`.

## Path parameters

- `brand_id` integer, required

## Response `200`

List of connections.

- object
  - `items` AiReferralsConnection[]
    - `id` string, required: ULID identifier for the connection.
    - `brand_id` integer, required
    - `website` string, required: Hostname or URL of the website whose referrals are pushed against this connection.
    - `provider` 'custom' | 'adobe_analytics', required: Where the data comes from: "custom" for any analytics tool, or "adobe_analytics". Both are read the same way.
    - `status` 'active' | 'disabled', required
    - `created_at` string, date-time, required
    - `last_pushed_at` string, date-time, nullable
    - `last_push_error` string, nullable
    - `sends_engagement` boolean: Whether the connection's rows carry users, engagement and key events. Set by its first push.

## Other responses

- `404`: Brand not found, or the AI Referrals API isn't enabled for it.
- `422`: Validation Error

## Changes

- **2026-11-05** `3c6aa69a6595`: 2 warning, 2 info
  - added the new `adobe_analytics` enum value to the `items/items/provider` response property for the response status `200`
  - added the new `custom` enum value to the `items/items/provider` response property for the response status `200`
  - added the non-success response with the status `404`
  - added the optional property `items/items/sends_engagement` to the response with the `200` status

[Operation history](https://skmtc.dev/scrunch/apis/scrunch-data-api/changes/:brand_id/ai-referrals/connections/get.md)

---

[API](https://skmtc.dev/scrunch/apis/scrunch-data-api.md) - [All operations](https://skmtc.dev/scrunch/apis/scrunch-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/scrunch/apis/scrunch-data-api/revisions/e28a10a186bf?raw)