> ## 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.

# Obtenir un run

> Lisez les détails de planification d’un run, dont les éléments demandés et planifiés et le nombre de tentatives. Utilisez le Location renvoyé au lancement.

Renvoie les métadonnées de planification d’un run appartenant à votre workspace et à votre équipe. C’est la ressource identifiée par l’en-tête `Location` de [Lancer un run](https://docs.qwairy.co/fr/developers/endpoints/runs/manage.md). 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.

**runId** `string` *required*

Identifiant du run renvoyé par une création de run ou une requête de liste.

## Réponse

Renvoie `200`, `success: true`, `run` et `Cache-Control: private, no-store`.

| Champ du run | Signification |
| - | - |
| `id`, `purpose`, `priority` | Identité du run et catégorie de planification |
| `promptCount`, `modelCount` | Dimensions des cibles demandées |
| `requestedCount`, `plannedCount` | Nombre d’éléments de travail demandés et planifiés |
| `attemptCount` | Nombre d’enregistrements de tentatives, et non de réponses terminées |
| `planningCompletedAt` | Date de fin de planification au format ISO 8601, ou null |
| `planningFailed` | Indique si la planification a enregistré un échec |
| `createdAt`, `updatedAt` | Horodatages ISO 8601 |

> [!NOTE]
>
> La fin de la planification ne signifie pas que toutes les réponses sont terminées. Cette réponse n’a ni statut global du run ni pourcentage d’avancement. Utilisez [Lister les runs](https://docs.qwairy.co/fr/developers/endpoints/runs/list.md) pour `status`, le décompte des résultats et `progressPercentage`.

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

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

```json theme={null}
{
  "success": true,
  "run": {
    "id": "55555555-0000-4000-8000-000000000000",
    "purpose": "MANUAL",
    "priority": "URGENT",
    "promptCount": 12,
    "modelCount": 2,
    "requestedCount": 24,
    "plannedCount": 24,
    "attemptCount": 24,
    "planningCompletedAt": "2026-09-01T09:00:01.000Z",
    "planningFailed": false,
    "createdAt": "2026-09-01T09:00:00.000Z",
    "updatedAt": "2026-09-01T09:00:01.000Z"
  }
}
```

## Erreurs

Un workspace inaccessible renvoie `404 BRAND_NOT_FOUND` ; un run inaccessible renvoie `404 RESOURCE_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.