---
title: "Get brand context"
method: GET
path: "/intelligence/brand-context"
tags: ["Intelligence"]
---

# Get brand context

`GET /intelligence/brand-context`

## Request

- Base URL: `https://app.uselamina.ai/v1`
- URL: `https://app.uselamina.ai/v1/intelligence/brand-context`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Retrieve workspace brand DNA, workflow guidance, and top-performing content patterns. Used to inform content creation.

## Query parameters

- `brandProfileId` string, uuid
- `campaignId` string, uuid
- `workflowId` string, uuid
- `platform` string
- `objective` string
- `marketCode` string
- `productKey` string
- `modality` 'image' | 'video' | 'text' | 'audio' | 'mixed'
- `topK` integer

## Response `200`

Brand context package

- object
  - `data` BrandContext, required
    - `brandDna` BrandDna, nullable
      - `voiceAttributes` string[]
      - `visualIdentity` string[]
      - `contentPillars` string[]
      - `audienceSignals` string[]
      - `guardrails` string[]
      - `toneSpectrum` ToneSpectrum, nullable
        - `primary` string, nullable
        - `secondary` string, nullable
        - `avoid` string[]
      - `performanceProfile` PerformanceProfile, nullable
        - `topPatterns` string[]
        - `weakPatterns` string[]
        - `avgEngagementTier` string, nullable
    - `brandIdentity` BrandIdentity, nullable
      - `category.primary` string, nullable
      - `category.sub` string, nullable
      - `offering` string[]
      - `business_model` string, nullable
      - `price_tier` string, nullable
      - `value_proposition` string, nullable
      - `proof_point` string[]
      - `audience.segment` string[]
      - `market.geography` string[]
      - `market.language` string[]
      - `market.currency` string, nullable
      - `seasonality.moment` string[]
    - `brandStrategy` BrandStrategy, nullable: Accepted evidence-backed public brand strategy for the selected scope.
      - `tagline` string, nullable
      - `mission` string, nullable
      - `goals` string[]
      - `values` string[]
      - `differentiators` string[]
      - `messagingPillars` string[]
      - `audienceNeeds` string[]
      - `voiceDirectives` object[]
        - `text` string, required
        - `kind` 'use' | 'avoid', required
    - `brandObjectives` BrandObjective[]
      - `id` string, uuid, required
      - `type` string, required
      - `statement` string, required
      - `successMeasure` string, nullable
      - `priority` integer, required
      - `claimScope` 'global' | 'market' | 'product', required
      - `scopeKey` string, required
      - `scopeLabel` string, nullable
      - `startsAt` string, date-time, nullable
      - `endsAt` string, date-time, nullable
      - `currentlyApplicable` true, required
      - `revision` integer, required
    - `guidance` GuidancePackage, nullable
      - `promptDirectives` string[]
      - `negativePrompts` string[]
      - `recommendedMoves` string[]
      - `testIdeas` string[]
      - `winningPatterns` string[]
      - `weakPatterns` string[]
      - `supportingMetrics` string[]
      - `creativeStructure` unknown
    - `topPatterns` TopPatterns, nullable
      - `topItems` TopPatternItem[]
        - `id` string
        - `title` string, nullable
        - `modality` string, nullable
        - `platform` string, nullable
        - `performanceScore` number
        - `winningPatterns` string[]
      - `topPatterns` PatternSummary[]
        - `pattern` string
        - `occurrences` integer
        - `avgPerformance` number
      - `weakPatterns` PatternSummary[]
        - `pattern` string
        - `occurrences` integer
        - `avgPerformance` number

## Other responses

- `401`: Missing or invalid API key
- `500`: Internal server error

---

[API](https://skmtc.dev/uselamina/apis/lamina-v1-api.md) · [All operations](https://skmtc.dev/uselamina/apis/lamina-v1-api/llms.txt) · [OpenAPI document](https://skmtc.dev/uselamina/apis/lamina-v1-api/revisions/73b598526531?raw)