> ## 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 Perception Snapshot

> Full detail of a single perception snapshot: scores, attribute alignment and SWOT

Retrieve the full detail of a single completed perception snapshot: the four scores, the attribute alignment breakdown and the SWOT insights. Get a `snapshotId` from the [Brand Perception](/developers/endpoints/perception/list) endpoint's `history` array.

<ParamField header="Authorization" type="string" required>
  Bearer token. Example: `Bearer qw-api-xxx`
</ParamField>

### Path Parameters

<ParamField path="brandId" type="string" required>
  The unique identifier of the brand
</ParamField>

<ParamField path="snapshotId" type="string" required>
  The unique identifier of the perception snapshot
</ParamField>

### Response

<ResponseField name="success" type="boolean">
  Indicates if the request was successful
</ResponseField>

<ResponseField name="brand" type="object">
  `id`, `name`, `domain`
</ResponseField>

<ResponseField name="snapshot" type="object">
  <Expandable title="Snapshot">
    <ResponseField name="snapshotId" type="string">Snapshot ID</ResponseField>
    <ResponseField name="month" type="number">Month (1-12)</ResponseField>
    <ResponseField name="year" type="number">Year</ResponseField>
    <ResponseField name="scores" type="object">`sentiment`, `alignment`, `consistency`, `factualAlignment` (0-100 or `null`)</ResponseField>

    <ResponseField name="attributes" type="array">
      Brand attributes evaluated by AI. Each object has `text` (string) and `status` (`aligned`, `partial`, `missing`).
    </ResponseField>

    <ResponseField name="attributeMetrics" type="object">
      Counts: `aligned`, `partial`, `missing`, `total`.
    </ResponseField>

    <ResponseField name="insights" type="object">
      SWOT arrays of strings: `strengths`, `weaknesses`, `opportunities`, `threats`.
    </ResponseField>

    <ResponseField name="providers" type="array">AI providers included in the analysis</ResponseField>
    <ResponseField name="createdAt" type="string">Creation timestamp (ISO 8601)</ResponseField>
    <ResponseField name="completedAt" type="string">Completion timestamp (ISO 8601) or `null`</ResponseField>
  </Expandable>
</ResponseField>

A `404 RESOURCE_NOT_FOUND` is returned if the snapshot does not exist, is not `COMPLETED`, or does not belong to the brand.

### Example Request

```bash theme={null}
curl -X GET "https://www.qwairy.co/api/v1/brands/cm1234567890abcdef/perception/snap_2026_05" \
  -H "Authorization: Bearer qw-api-your-token-here"
```

### Example Response

```json theme={null}
{
  "success": true,
  "brand": {
    "id": "cm1234567890abcdef",
    "name": "My Brand",
    "domain": "mybrand.com"
  },
  "snapshot": {
    "snapshotId": "snap_2026_05",
    "month": 5,
    "year": 2026,
    "scores": {
      "sentiment": 78,
      "alignment": 65,
      "consistency": 82,
      "factualAlignment": 71
    },
    "attributes": [
      { "text": "Premium positioning", "status": "aligned" },
      { "text": "Sustainable materials", "status": "partial" },
      { "text": "Made in France", "status": "missing" }
    ],
    "attributeMetrics": {
      "aligned": 1,
      "partial": 1,
      "missing": 1,
      "total": 3
    },
    "insights": {
      "strengths": ["Strong brand recognition in core market"],
      "weaknesses": ["Limited awareness of product range"],
      "opportunities": ["Growing demand in adjacent category"],
      "threats": ["Aggressive competitor messaging"]
    },
    "providers": ["chatgpt", "perplexity"],
    "createdAt": "2026-05-01T03:00:00.000Z",
    "completedAt": "2026-05-03T04:12:00.000Z"
  }
}
```