---
title: "List your satellite runs"
method: GET
path: "/v1/satellite/runs"
tags: ["Satellite"]
---

# List your satellite runs

`GET /v1/satellite/runs`

## Request

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

Paginated history of every satellite run your team has ever performed. Optionally filter by `type` (creator_lookup, sound_lookup, hashtag_lookup, ...) and/or `platform`. Free to call.

## Query parameters

- `type` 'creator_lookup' | 'sound_lookup' | 'hashtag_lookup' | 'video_outlier' | 'batch_creator'
- `platform` 'tiktok' | 'youtube' | 'instagram'
- `limit` number
- `offset` number

## Response `200`

List returned

- ListSatelliteRunsResponseDto
  - `data` ListSatelliteRunsResponseDataDto, required
    - `runs` SatelliteRunSummaryDto[], required
      - `run_id` string, required
      - `type` 'creator_lookup' | 'sound_lookup' | 'hashtag_lookup' | 'video_outlier' | 'batch_creator', required: Discriminator: which kind of satellite run this is.
      - `platform` string, required
      - `status` string, required
      - `subject` string, nullable
      - `created_at` string, date-time, required
      - `completed_at` string, date-time, nullable
      - `credits_used` number, nullable
    - `total` number, required
    - `limit` number, required
    - `offset` number, 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)