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

# Get perception prompts & responses (brand)

> Return all perception prompts and their scored responses for a brand, optionally scoped to a run.

Returns perception prompts and all associated LLM responses for a brand. Defaults to the most recent run if `runId` is not provided.

### Path parameters

<ParamField path="brandId" type="string" required>
  Brand UUID. Obtain from [List brands](/api-reference/brands/list).
</ParamField>

### Query parameters

<ParamField query="runId" type="string">
  Target a specific run. If omitted, the most recent run is used.
</ParamField>

### Request

```bash theme={null}
curl -s \
  -H "x-spotlight-api-key: YOUR_API_KEY" \
  "https://app.get-spotlight.com/api/v1/brands/BRAND_ID/perception-prompts-responses?runId=RUN_ID"
```

### Response

Same shape as [Get brand perception](/api-reference/perception/get-brand-perception).
