---
title: "Get insights"
method: GET
path: "/v1/insights"
tags: ["Insights"]
---

# Get insights

`GET /v1/insights`

## Request

- Base URL: `https://app.nex.ai/api/developers`
- URL: `https://app.nex.ai/api/developers/v1/insights`
- Auth: API key in header `Authorization`

Retrieve insights for the workspace. Supports three query modes: 'last' for a rolling time window (e.g., '30m', '2h'), 'from'/'to' for a date range (RFC3339), or no time params for most recent insights.

## Query parameters

- `last` string
- `from` string, date-time
- `to` string, date-time
- `limit` integer

## Response `200`

List of insights

- DeveloperInsightsResponse
  - `data` DeveloperInsightResponse[]: Array of insight objects
    - `id` string: Unique insight identifier
    - `workspace_id` string: Workspace the insight belongs to
    - `content` string: Human-readable insight text
    - `type` string: Insight category or type
    - `entities` object[]: Entities referenced in this insight
      - `id` string
      - `name` string
      - `type` string
    - `created_at` string, date-time: When the insight was generated

## Other responses

- `400`: Bad request - Invalid query parameters
- `401`: Unauthorized - Invalid or missing API key
- `500`: Internal server error

## Changes

- **2026-02-17** `ee723ea4717a`: 1 info
  - endpoint added
- **2026-02-17** `b05d8cb8cf43`: 1 breaking
  - api path removed without deprecation
- **2026-02-10** `d32bd7d3eaba`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/nex/apis/nex-developer-api/changes/v1/insights/get.md)

---

[API](https://skmtc.dev/nex/apis/nex-developer-api.md) - [All operations](https://skmtc.dev/nex/apis/nex-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nex/apis/nex-developer-api/revisions/51003af13108?raw)
