> ## 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 une génération de suggestions

> Lisez le statut d’une génération de Prompt Studio : en attente, en cours, terminée ou échouée, avec le nombre de recommandations une fois qu’elle est finie.

Renvoie le statut d’une génération. C’est la ressource identifiée par l’en-tête `Location` de [Générer des suggestions de prompts](https://docs.qwairy.co/fr/developers/endpoints/prompt-suggestions/generate.md). Lorsqu’elle est `COMPLETED`, lisez les suggestions avec [Obtenir les suggestions de prompts](https://docs.qwairy.co/fr/developers/endpoints/prompt-suggestions/get.md).

Disponible avec les offres Growth, Agency Growth, Business, Agency Business et Enterprise. Consultez [Authentification](https://docs.qwairy.co/fr/developers/authentication.md).

**Authorization** `string` *required*

Jeton bearer de votre équipe.

**brandId** `string` *required*

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

**suggestionRunId** `string` *required*

Identifiant de la génération renvoyé au démarrage de la génération.

## Réponse

**id** `string`

Identifiant de la génération

**status** `string`

`PENDING`, `RUNNING`, `COMPLETED` ou `FAILED`

**source** `string`

`manual`, `onboarding`, `topic` ou `profile`

**keywordId** `string | null`

Topic ciblé par la génération, lorsque `source` vaut `topic`

**recommendations** `integer | null`

Nombre de suggestions recommandées, une fois connu

**createdAt** `string`

Date de création au format ISO 8601

**completedAt** `string | null`

Date de fin au format ISO 8601, ou `null` tant que la génération est en cours

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

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

```json theme={null}
{
  "id": "bbbbbbbb-0000-4000-8000-000000000000",
  "status": "COMPLETED",
  "source": "manual",
  "keywordId": null,
  "recommendations": 20,
  "createdAt": "2026-10-12T09:00:00.000Z",
  "completedAt": "2026-10-12T09:02:00.000Z"
}
```

## Erreurs

| Statut | Code | Cause |
| - | - | - |
| `401` | Corps plat | Jeton absent ou invalide |
| `403` | `INSUFFICIENT_PLAN` | Refus d’offre générique : `"This endpoint is not included in the team's plan."` |
| `404` | `RESOURCE_NOT_FOUND` | Le workspace ou la génération est absent ou inaccessible |

Les erreurs de lecture utilisent les formes plate ou imbriquée décrites dans [Codes d’erreur](https://docs.qwairy.co/fr/developers/errors.md). Sur `429`, respectez `Retry-After`.


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