---
title: "List Insights"
method: GET
path: "/v0/aoi/{aoiId}/insights"
tags: ["Insights"]
---

# List Insights

`GET /v0/aoi/{aoiId}/insights`

## Request

- Base URL: `https://api.pixxel.space`
- URL: `https://api.pixxel.space/v0/aoi/{aoiId}/insights`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/pixxel/apis/stargate/docs/v0/aoi/:aoiId/insights/get.ts> (a function with typed inputs; its response is checked against the schema)

Responds with the list of inisghts details as JSON.

## Path parameters

- `aoiId` string, required

## Query parameters

- `id` string
- `status` string
- `created_by` string
- `created_on` string

## Response `200`

OK

- DexterListInsightsTransformerResponse
  - `insights` DexterListInsightItem[]
    - `name` string: Display name of the insight
    - `created_at` string: Timestamp when the insight was created
    - `err_msg` string: Contains any error message if the insight processing failed
    - `created_by` string: Identifies the user who created this insight
    - `estimated_time_in_min` integer: Expected processing time in minutes
    - `deleted_at` string: Timestamp when the insight was deleted, null if not deleted
    - `id` string: Unique identifier for the insight
    - `status` string: Represents the current processing status of the insight
    - `input` integer[]: Contains the raw input data provided for the insight
    - `output` integer[]: Contains the raw result data generated by the insight
    - `metadata` object: Contains additional key-value information about the insight
    - `aoi_id` string: Identifier of the area of interest this insight belongs to
    - `cost` integer: Represents the computational cost or credits used for this insight
    - `progress` number: Indicates the completion percentage of the insight processing

## Other responses

- `400`: Bad Request
- `403`: Forbidden

---

[API](https://skmtc.dev/pixxel/apis/stargate.md) - [All operations](https://skmtc.dev/pixxel/apis/stargate/llms.txt) - [OpenAPI document](https://skmtc.dev/pixxel/apis/stargate/revisions/519562bd9d7a?raw)