---
title: "List intents"
method: GET
path: "/v1/environments/{environmentId}/intents"
tags: ["insights"]
---

# List intents

`GET /v1/environments/{environmentId}/intents`

List grouped user intents for an environment over a time range

## Path parameters

- `environmentId` string, required — The ID of the environment

## Query parameters

- `since` string — Start time — ISO 8601 (2024-01-01T00:00:00Z) or relative (1h, 30m, 2d)
- `until` string — End time — ISO 8601 or relative
- `limit` integer
- `offset` integer
- `search` string
- `tools` string[]
- `clientIds` string[]
- `categoryIds` string[]
- `sortDir` 'asc' | 'desc'

## Response `200`

The grouped user intents

- object
  - `intents` object[], required
    - `id` string, required
    - `intentIds` string[], required
    - `environmentId` string, required
    - `message` string, required
    - `toolName` string, required
    - `createdAt` string, date-time, required
    - `occurrenceCount` integer, required
    - `clientName` string, nullable, required
    - `clientId` string, nullable, required
    - `categories` object[], required
      - `id` string, required
      - `name` string, required
      - `color` 'red' | 'orange' | 'yellow' | 'green' | 'blue' | 'purple' | 'pink' | 'gray', required
  - `totalCount` integer, required

## Other responses

- `400` — 400
- `404` — 404

## Changes

- **2026-08-13** `90e2584a7c1c` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/alpic/apis/alpic-api/changes/v1/environments/:environmentId/intents/get.md)

---

[API](https://skmtc.dev/alpic/apis/alpic-api.md) · [All operations](https://skmtc.dev/alpic/apis/alpic-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/alpic/alpic-api/revisions/262875478562/schema)