---
title: "List explores"
method: GET
path: "/api/v1/projects/{projectUuid}/explores"
tags: ["Projects"]
---

# List explores

`GET /api/v1/projects/{projectUuid}/explores`

Get all explores for a project

## Path parameters

- `projectUuid` string, required

## Response `200`

Success

- object
  - `results` SummaryExplore[], required
    - union
      - object — From T, pick a set of properties whose keys are in the union K
        - `name` string, required
        - `label` string, required
        - `type` 'virtual' | 'default' | 'pre_aggregate'
        - `tags` string[], required
        - `groupLabel` string
        - `groups` string[] — Nested groups for the sidebar (max 5 levels). Group keys resolve to labels/descriptions via the project-level `table_groups` config (fetched separately); missing keys fall back to using the key as the label.
        - `aiHint` union
          - string
          - string[]
        - `preAggregateSource` PreAggregateSource
          - `preAggregateName` string, required
          - `sourceExploreName` string, required
        - `warnings` InlineError[] — Non-fatal compilation or validation warnings (e.g. fields that failed to compile, warehouse-rejected column references). The explore is still usable.
          - `message` string, required
          - `type` 'METADATA_PARSE_ERROR' | 'NO_DIMENSIONS_FOUND' | 'SKIPPED_JOIN' | 'MISSING_TABLE' | 'FIELD_ERROR' | 'SET_VALIDATION_ERROR' | 'INVALID_PARAMETER' | 'DUPLICATE_FIELD_NAME' | 'WAREHOUSE_COLUMN_ERROR', required
        - `databaseName` string, required
        - `schemaName` string, required
        - `description` string
      - object — Make all properties in T optional
        - `name` string, required
        - `label` string, required
        - `type` 'virtual' | 'default' | 'pre_aggregate'
        - `tags` string[]
        - `groupLabel` string
        - `groups` string[] — Nested groups for the sidebar (max 5 levels). Group keys resolve to labels/descriptions via the project-level `table_groups` config (fetched separately); missing keys fall back to using the key as the label.
        - `aiHint` union
          - string
          - string[]
        - `errors` InlineError[], required
          - `message` string, required
          - `type` 'METADATA_PARSE_ERROR' | 'NO_DIMENSIONS_FOUND' | 'SKIPPED_JOIN' | 'MISSING_TABLE' | 'FIELD_ERROR' | 'SET_VALIDATION_ERROR' | 'INVALID_PARAMETER' | 'DUPLICATE_FIELD_NAME' | 'WAREHOUSE_COLUMN_ERROR', required
        - `description` string
        - `schemaName` string
        - `databaseName` string
  - `status` 'ok', required

## Other responses

- `default` — Error

---

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