> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qwairy.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Lister les runs

> Listez les runs récents d’un workspace, du plus récent au plus ancien, avec leur statut, le décompte des résultats et une pagination par curseur.

Liste les runs du workspace du plus récent au plus ancien. Utilisez cet endpoint pour suivre la collecte des réponses une fois qu’un run a été accepté. La lecture est disponible à partir de Growth et Agency Growth.

**Authorization** `string` *required*

Jeton bearer de votre équipe.

**brandId** `string` *required*

Identifiant du workspace. Le workspace doit appartenir à l’équipe du jeton.

**limit** `integer` (default: 20)

Nombre de runs par page, de 1 à 20.

**cursor** `string`

`nextCursor` opaque de la page précédente. Omettez-le pour la première page.

## Réponse

Renvoie `200` avec `success`, `runs`, `nextCursor`, `totalCount` et `activeCount`. Les totaux décrivent le workspace entier, pas seulement la page renvoyée. `nextCursor: null` signifie qu’il n’y a pas de page suivante. Les réponses sont `private, no-store`.

Chaque run inclut son identité et ses horodatages, `purpose`, `priority`, `scheduledFrequency` (nullable), `questionCount`, `modelCount`, `requestedCount`, `plannedCount`, `planningCompletedAt`, `planningFailed`, `status`, `counts`, `terminalCount` et `progressPercentage`.

Le statut est l’un de `QUEUED`, `PROCESSING`, `COMPLETED`, `COMPLETED_WITH_WARNINGS`, `FAILED`, `CANCELLED` ou `NO_WORK`. `counts` distingue `success`, `warning`, `failed`, `cancelled`, `processing`, `queued` et `skipped`. L’avancement ne garantit pas que chaque réponse demandée a réussi ; examinez le statut et le décompte des résultats.

## Requête et réponse synthétiques

```bash theme={null}
curl "https://www.qwairy.co/api/v1/brands/$BRAND_ID/runs?limit=20" \
  -H "Authorization: Bearer $QWAIRY_API_TOKEN"
```

```json theme={null}
{
  "success": true,
  "totalCount": 1,
  "activeCount": 0,
  "runs": [
    {
      "id": "55555555-0000-4000-8000-000000000000",
      "purpose": "MANUAL",
      "priority": "URGENT",
      "scheduledFrequency": null,
      "questionCount": 12,
      "modelCount": 2,
      "requestedCount": 24,
      "plannedCount": 24,
      "planningCompletedAt": "2026-09-01T09:00:01.000Z",
      "planningFailed": false,
      "createdAt": "2026-09-01T09:00:00.000Z",
      "updatedAt": "2026-09-01T09:03:00.000Z",
      "status": "COMPLETED",
      "counts": {
        "success": 24,
        "warning": 0,
        "failed": 0,
        "cancelled": 0,
        "processing": 0,
        "queued": 0,
        "skipped": 0
      },
      "terminalCount": 24,
      "progressPercentage": 100
    }
  ],
  "nextCursor": null
}
```

## Erreurs

Des curseurs ou des limites invalides renvoient `400 INVALID_PARAMETER` ; un workspace inaccessible renvoie `404 BRAND_NOT_FOUND`. Consultez [Codes d’erreur](https://docs.qwairy.co/fr/developers/errors.md) et respectez `Retry-After` sur `429`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.