> ## 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 account presences (alpha)
> Read seller-discovered and pushed audiences/event sources tracked on a connected account
Alpha. This operation requires the `directed-campaigns` mirror gate, same as
the other storefront-connection drill-in endpoints. It is read-only.
Returns the presence edges the platform has recorded for one connected
account: audiences and event sources the seller reports (`tracked`), plus any
buyer-level audiences or event sources already delivered to that account
through AdCP pass-through (`pushed`). This is a reference-only surface --
identity, sync status, and counts -- never member lists or event payloads. See
[Presences: audiences and event sources](/v2/buyer/campaigns/directed-campaigns#presences-audiences-and-event-sources)
for the tracked/pushed model.
**Named operation:** `list_storefront_connection_account_presences`
## Request
```bash theme={null}
curl \
"https://api.interchange.io/api/v2/buyer/storefront-connections/42/accounts/81/presences?objectType=audience" \
-H "Authorization: Bearer $SCOPE3_API_KEY"
```
## Parameters
| Field | Location | Type | Required | Description |
| ---------------- | -------- | ---------------------------- | -------- | -------------------------------------------------------------- |
| `connectionId` | path | integer | Yes | Active official-adapter connection ID |
| `accountId` | path | integer | Yes | Buyable provider-account row selected from the connection |
| `objectType` | query | `audience` \| `event_source` | No | Filter to one presence object type |
| `includeRetired` | query | boolean | No | Include retired (terminal) presence edges. Defaults to `false` |
| `take` | query | integer | No | Page size (default 50, max 250) |
| `skip` | query | integer | No | Offset for pagination (default 0) |
## Response
```json theme={null}
{
"presences": [
{
"id": "1201",
"objectType": "audience",
"direction": "tracked",
"upstreamObjectId": "snap_audience_44521",
"syncState": "live",
"lastSyncedAt": "2026-07-24T12:00:00.000Z",
"rowCount": 48213,
"retiredAt": null,
"createdAt": "2026-07-20T09:00:00.000Z",
"updatedAt": "2026-07-24T12:00:00.000Z"
},
{
"id": "1202",
"objectType": "audience",
"direction": "pushed",
"upstreamObjectId": "talpa_audience_998",
"audienceId": "5521",
"syncState": "live",
"lastSyncedAt": "2026-07-24T12:00:00.000Z",
"rowCount": 12000,
"retiredAt": null,
"createdAt": "2026-07-18T09:00:00.000Z",
"updatedAt": "2026-07-24T12:00:00.000Z"
}
],
"total": 2
}
```
Every row carries `direction`:
* **`tracked`** -- a seller-discovered object. There is no buyer-level master
yet; `audienceId`/`eventSourceId` are omitted entirely until the object is
explicitly adopted.
* **`pushed`** -- a buyer-level object already delivered to this account
through AdCP pass-through. The matching master id (`audienceId` for
`objectType: "audience"`, `eventSourceId` for `objectType: "event_source"`)
is always present.
`rowCount` and `lastSyncedAt` reflect the last successful sync only; the
platform never stores the members or events themselves (custody is a
separate, explicitly consented capability -- see
[Presences: audiences and event sources](/v2/buyer/campaigns/directed-campaigns#presences-audiences-and-event-sources)).
`retiredAt` is `null` unless the seller reported a terminal status (deleted,
suspended, failed) for the object; pass `includeRetired=true` to see retired
edges. `total` is the count across all pages. Results use offset pagination
(`take` / `skip`); see [Pagination](/v2/reference/pagination).
## Errors
* `403 FEATURE_NOT_ENABLED` -- the customer lacks directed-campaigns mirror
access.
* `404 NOT_FOUND` -- the connection/account does not belong to this customer,
or does not exist.
See [Errors](/v2/reference/errors) for the full error contract.
## Related
The connected-account model presences live on
Connecting and mapping provider accounts
Offset-based list paging