---
title: "List recent tracked runs"
method: GET
path: "/tracking/status"
tags: ["Track Accounts"]
---

# List recent tracked runs

`GET /tracking/status`

## Request

- Base URL: `https://viral.app/api/v1`
- URL: `https://viral.app/api/v1/tracking/status`
- Auth: API key in header `x-api-key`

Returns recent user-triggered sync runs including current status, timestamps, and grouping metadata. Useful for polling task execution progress.

## Query parameters

- `days` number
- `limit` number
- `groupId` string, nullable
- `eventIds` string[], nullable
- `status` string[], nullable

## Response `200`

OK

- object
  - `runs` object[], required
    - `id` string, required
    - `eventId` string, nullable, required
    - `groupId` string, nullable, required
    - `runId` string, nullable, required
    - `status` 'Queued' | 'Running' | 'Completed' | 'Failed' | 'Cancelled' | 'Skipped', required
    - `platform` 'facebook' | 'instagram' | 'tiktok' | 'youtube' | 'snapchat', nullable, required: Social media platform (facebook, instagram, tiktok, youtube, snapchat)
    - `dataType` 'accounts' | 'videos' | 'unknown', required
    - `identifier` string, nullable, required
    - `syncContext` 'scheduled' | 'probe' | 'onboarding' | 'user_add' | 'user_refresh', nullable, required
    - `createdAt` string, date-time, required
    - `runStartedAt` string, date-time, nullable, required
    - `endedAt` string, date-time, nullable, required
    - `updatedAt` string, date-time, required
  - `lastUpdatedAt` string, date-time, required

## Other responses

- `400`: 400
- `401`: 401
- `402`: 402
- `404`: 404
- `408`: 408
- `429`: 429
- `500`: 500

---

[API](https://skmtc.dev/viral/apis/viral-app-api.md) · [All operations](https://skmtc.dev/viral/apis/viral-app-api/llms.txt) · [OpenAPI document](https://skmtc.dev/viral/apis/viral-app-api/revisions/31e97fa79ef1?raw)