---
title: "Get Narratives"
method: GET
path: "/narratives"
tags: ["public-api"]
---

# Get Narratives

`GET /narratives`

## Request

- Base URL: `https://api.trakkr.ai`
- URL: `https://api.trakkr.ai/narratives`
- Auth: HTTP bearer

List narratives or get a single narrative detail.

Without narrative_id: returns all narratives for the brand.
With narrative_id: returns single narrative with latest snapshot and correctives.
Use include=snapshots to embed snapshot history, include=correctives for correctives.

Requires Scale plan.

## Query parameters

- `brand_id` string, uuid, required: Brand UUID
- `narrative_id` string, nullable: Specific narrative ID for detail view
- `include` string, nullable: Comma-separated: snapshots,correctives
- `days` integer: Days for snapshot history

## Response `200`

Successful Response

- union
  - NarrativesListApiResponse: GET /narratives response (list).
    - `narratives` NarrativeItemApi[], required
      - `id` string, required
      - `brand_id` string, required
      - `name` string, required
      - `description` string, required
      - `keywords` string[]
      - `comparison_brand` string, nullable
      - `status` string, required
      - `created_at` string, required
      - `latest_snapshot` NarrativeSnapshotApi: Narrative snapshot summary.
        - `id` string, required
        - `run_date` string, required
        - `run_type` string, required
        - `overall_score` number, nullable
        - `summary` string, nullable
        - `comparison_score` number, nullable
        - `themes` object[], nullable
      - `correctives` NarrativeCorrectiveApi[], nullable
        - `id` string, required
        - `name` string, required
        - `key_phrases` string[]
        - `url` string, nullable
        - `published_at` string, nullable
        - `created_at` string, nullable
      - `snapshots` NarrativeSnapshotApi[], nullable
        - `id` string, required
        - `run_date` string, required
        - `run_type` string, required
        - `overall_score` number, nullable
        - `summary` string, nullable
        - `comparison_score` number, nullable
        - `themes` object[], nullable
  - NarrativeItemApi: Narrative in the API response.
    - `id` string, required
    - `brand_id` string, required
    - `name` string, required
    - `description` string, required
    - `keywords` string[]
    - `comparison_brand` string, nullable
    - `status` string, required
    - `created_at` string, required
    - `latest_snapshot` NarrativeSnapshotApi: Narrative snapshot summary.
      - `id` string, required
      - `run_date` string, required
      - `run_type` string, required
      - `overall_score` number, nullable
      - `summary` string, nullable
      - `comparison_score` number, nullable
      - `themes` object[], nullable
    - `correctives` NarrativeCorrectiveApi[], nullable
      - `id` string, required
      - `name` string, required
      - `key_phrases` string[]
      - `url` string, nullable
      - `published_at` string, nullable
      - `created_at` string, nullable
    - `snapshots` NarrativeSnapshotApi[], nullable
      - `id` string, required
      - `run_date` string, required
      - `run_type` string, required
      - `overall_score` number, nullable
      - `summary` string, nullable
      - `comparison_score` number, nullable
      - `themes` object[], nullable

## Other responses

- `401`: Missing, malformed, or expired credentials
- `402`: The current plan does not fund this operation
- `403`: Invalid credentials, missing brand access, or insufficient role
- `422`: Validation Error
- `429`: Rate limit exceeded
- `500`: The operation failed
- `503`: Authentication, entitlement, or a required dependency is temporarily unavailable

---

[API](https://skmtc.dev/trakkr/apis/trakkr-api.md) · [All operations](https://skmtc.dev/trakkr/apis/trakkr-api/llms.txt) · [OpenAPI document](https://skmtc.dev/trakkr/apis/trakkr-api/revisions/189a9e76b8d5?raw)