---
title: "List visualizations for an AOI"
method: GET
path: "/v0/aois/{aoi_id}/visualizations"
tags: ["Visualizations"]
---

# List visualizations for an AOI

`GET /v0/aois/{aoi_id}/visualizations`

## Request

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

Lists all visualizations for a given AOI with optional filtering

## Path parameters

- `aoi_id` string, required

## Query parameters

- `offset` integer
- `limit` integer
- `type` string
- `user_id` string
- `expression_type` string
- `index_id` string
- `visualization_id` string

## Response `200`

OK

- AtlasVisualizationListResponse
  - `pagination` CommonPagination
    - `limit` integer
    - `offset` integer
    - `total` integer
  - `visualization` AtlasVisualizationListItem[]
    - `aoi_id` string
    - `created_at` string
    - `id` string
    - `index_id` string
    - `progress` integer
    - `status` 'creating' | 'success' | 'failed' | 'partial_success'
    - `tenant_id` string
    - `updated_at` string
    - `user_id` string

## Other responses

- `403`: Forbidden
- `500`: Internal Server Error

---

[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)