---
title: "Feed"
method: GET
path: "/admin/client-events"
tags: ["telemetry"]
---

# Feed

`GET /admin/client-events`

## Request

- Base URL: `https://api.instruxi.dev/api/v1/enforcer`
- URL: `https://api.instruxi.dev/api/v1/enforcer/admin/client-events`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `X-API-Key`

Client telemetry for the caller's own tenant by default — a platform admin included; a platform admin passes tenant_id for another tenant or all_tenants=true for every tenant. A non-admin passing a FOREIGN tenant_id or all_tenants gets 403 rather than being silently shown their own tenant's feed. source is a CSV of event sources (e.g. plaid_link,bank_link_exchange,plaid_refresh_patch,external_bank_unlink,bank_link_funnel); session_id matches either the server-stamped session_id or an external_session_id (e.g. a Privy sid). account_id narrows to one account; group_id / exclude_group_id to (non-)members of a group, by the event's account. from/to bound created_at (half-open, ADR 0003 dates) inside the 30-day retention window. Newest first by default; sort=oldest reverses; ties break on id.

## Query parameters

- `source` string
- `event` string
- `account_id` string, uuid
- `group_id` string, uuid
- `exclude_group_id` string, uuid
- `from` string
- `to` string
- `sort` 'recent' | 'oldest'
- `limit` integer
- `offset` integer
- `session_id` string
- `tenant_id` string, uuid
- `all_tenants` boolean

## Response `200`

OK

- InternalDeliveryHttpHandlerClientEventListResponse
  - `events` EnforcerV3InternalDomainTelemetryClientEvent[]
    - `account_id` string
    - `context` integer[]
    - `created_at` string
    - `event` string
    - `id` string
    - `message` string
    - `source` string
    - `tenant_id` string
  - `limit` integer
  - `offset` integer
  - `total` integer

## Other responses

- `400`: invalid_request | invalid_account_id | invalid_group_id | invalid_exclude_group_id | invalid_from | invalid_to | invalid_window
- `401`: Unauthorized
- `403`: Forbidden
- `404`: group_not_found

---

[API](https://skmtc.dev/instruxi/apis/enforcer-api.md) · [All operations](https://skmtc.dev/instruxi/apis/enforcer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/instruxi/apis/enforcer-api/revisions/fa82bc1becc0?raw)