---
title: "List all comet configurations"
method: GET
path: "/v1/comet"
tags: ["Comet"]
---

# List all comet configurations

`GET /v1/comet`

## Request

- Base URL: `https://api.virlo.ai`
- URL: `https://api.virlo.ai/v1/comet`
- Auth: HTTP bearer

Retrieves a list of all comet configurations.

## Query parameters

- `include_inactive` string

## Response `200`

Successfully retrieved configurations

- CometListResponseDto
  - `data` CometListDataDto, required
    - `total` number, required
    - `configurations` CometConfigDto[], required
      - `id` string, required
      - `name` string, required
      - `keywords` string[], required
      - `platforms` string[], required
      - `cadence` string, required: Cron expression for scheduling
      - `min_views` number, required
      - `time_range` string, required: today | this_week | this_month | this_year
      - `is_active` boolean, required
      - `is_processing` boolean, required
      - `meta_ads_enabled` boolean, required
      - `data_intelligence_enabled` boolean, required: Whether per-video AI intelligence is enabled. When true, each scheduled run costs $1.50 (base $0.50 + intelligence $1.00).
      - `last_run_at` string, nullable
      - `next_run_at` string, nullable
      - `created_at` string, required
      - `updated_at` string, required

## Other responses

- `401`: Unauthorized - missing or invalid API key
- `429`: Rate limit exceeded (`rate_limit_exceeded`); see the Retry-After header

---

[API](https://skmtc.dev/virlo/apis/virlo-public-api.md) · [All operations](https://skmtc.dev/virlo/apis/virlo-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/virlo/apis/virlo-public-api/revisions/3b69c6145087?raw)