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

# Get a suggestion generation

> Read the status of one Prompt Studio generation: pending, running, completed or failed, with the number of recommendations once it has finished.

Returns the status of one generation. This is the resource identified by the
`Location` header from
[Generate prompt suggestions](https://docs.qwairy.co/developers/endpoints/prompt-suggestions/generate.md). When it is
`COMPLETED`, read the suggestions with
[Get prompt suggestions](https://docs.qwairy.co/developers/endpoints/prompt-suggestions/get.md).

Available on Growth, Agency Growth, Business, Agency Business and Enterprise plans. See [Authentication](https://docs.qwairy.co/developers/authentication.md).

**Authorization** `string` *required*

Bearer token for your team.

**brandId** `string` *required*

Workspace identifier. The workspace must belong to the token's team.

**suggestionRunId** `string` *required*

Generation identifier returned when the generation started.

## Response

**id** `string`

Generation identifier

**status** `string`

`PENDING`, `RUNNING`, `COMPLETED` or `FAILED`

**source** `string`

`manual`, `onboarding`, `topic` or `profile`

**keywordId** `string | null`

Topic the generation targeted, when `source` is `topic`

**recommendations** `integer | null`

Number of recommended suggestions, once known

**createdAt** `string`

ISO 8601 creation time

**completedAt** `string | null`

ISO 8601 completion time, or `null` while the generation is in progress

## Synthetic request and response

```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"
}
```

## Errors

| Status | Code | Cause |
| - | - | - |
| `401` | Flat body | Missing or invalid token |
| `403` | `INSUFFICIENT_PLAN` | Generic plan refusal: "This endpoint is not included in the team's plan." |
| `404` | `RESOURCE_NOT_FOUND` | The workspace or generation is missing or inaccessible |

Read errors use the flat or nested shapes described in [Error codes](https://docs.qwairy.co/developers/errors.md). On `429`, honor `Retry-After`.


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