---
title: "List all AOIs"
method: GET
path: "/v0/aois"
tags: ["AOI"]
---

# List all AOIs

`GET /v0/aois`

List all Areas of Interest (AOIs) with optional filtering

## Query parameters

- `offset` integer
- `limit` integer
- `created_at` string
- `updated_at` string
- `aoi_id` string
- `aoi_name` string
- `project_ids` string

## Response `200`

OK

- AtlasAOIListResponse
  - `aois` AtlasAOI[]
    - `aoi_id` string — Unique identifier (UUID) of the created AOI
    - `name` string — Unique user friendly name of the AOI for easier identification
    - `description` string — Brief description of the AOI explaining its purpose or contents
    - `satellite_id` string — Unique identifier (UUID) for the satellite. Each satellite has a unique ID mapped to its name: - `Pixxel-TD1` - `0004ab8d-0ad1-4d62-8a3f-fe18a7000e70` - `Pixxel-TD2` - `0005c5bb-0bd2-4c80-9393-4a808341c54c`
    - `project_id` string — UUID of the project this AOI belongs to
    - `images` object — Map of images associated with the AOI, keyed by image identifier
    - `eo_bands` string[] — List of Earth Observation bands available for this AOI
    - `geometry` AtlasPolygon
      - `type` string, required — GeoJSON geometry type. Must be "Polygon" for AOI boundaries
      - `coordinates` array[], required — Nested array of coordinates [[[lng,lat],...]] forming a closed polygon. Example: [[[49.32, 40.85], [49.32, 9.08], [110.7, 9.08], [110.7, 40.85], [49.32, 40.85]]]
        - array[]
          - number[]
    - `progress` integer — Processing progress of the AOI from 0 to 100 in percentage
    - `status` 'success' | 'started' | 'running' | 'failed' | 'updating' | 'partial_success'
    - `is_favourite` boolean — Whether the AOI is marked as favourite by the user
    - `created_at` string — Timestamp when the AOI was created (ISO 8601 format)
    - `updated_at` string — Timestamp when the AOI was last updated (ISO 8601 format)
    - `user_id` string — Unique identifier of the user who created the AOI
    - `area_in_sq_m` number — Total area of the AOI in square meters
    - `centroid` number[] — Geographic centroid coordinates of the AOI [longitude, latitude]
  - `pagination` CommonPagination
    - `limit` integer
    - `offset` integer
    - `total` integer

## Other responses

- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/pixxel/apis/stargate.md) · [All operations](https://skmtc.net/pixxel/apis/stargate/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pixxel/stargate/versions/b501e2ca5a9d/schema)