---
title: "Single dream symbol lookup"
method: GET
path: "/v1/dreams/symbol/{name}"
tags: ["Dreams"]
---

# Single dream symbol lookup

`GET /v1/dreams/symbol/{name}`

## Request

- Base URL: `https://api.asterwise.com`
- URL: `https://api.asterwise.com/v1/dreams/symbol/{name}`
- Auth: HTTP bearer

Lookup a specific dream symbol by slug or name (case-insensitive). Examples: 'snake', 'eagle', 'childhood-home', 'teeth falling out'. Returns full dual-tradition interpretation including Jungian archetype, Vedic dream tradition meaning, context variants, and related symbols.

## Path parameters

- `name` string, required

## Response `200`

Successful Response

- ApiResponseDreamSymbol
  - `success` boolean: True if the request succeeded
  - `message` string: Human-readable status message
  - `data` DreamSymbol, required
    - `slug` string, required: URL-safe identifier.
    - `name` string, required: Display name of the symbol.
    - `category` string, required: Symbol category: animals, nature, people, places, objects, actions, body, or abstract.
    - `jungian_meaning` string, required: Jungian/Western psychological interpretation.
    - `jungian_archetype` string, required: Primary Jungian archetype activated by this symbol.
    - `vedic_meaning` string, required: Classical Vedic dream tradition interpretation.
    - `vedic_auspicious` boolean, nullable: True if auspicious (Shubha), False if inauspicious (Ashubha), null if mixed/context-dependent.
    - `traditions_agree` string, required: Whether Jungian and Vedic traditions agree: 'agree', 'conflict', or 'partial'.
    - `emotional_tone` string, required: Primary emotional register: anxiety, transformation, auspicious, warning, grief, power, healing, clarity, confusion, or neutral.
    - `themes` string[], required: Thematic keywords used for AI synthesis and search.
    - `context_variants` ContextVariant[], required: Alternative readings depending on dream context.
      - `context` string, required: The specific dream context or variant.
      - `meaning` string, required: The interpretation for this specific context.
    - `related_symbols` string[], required: Slugs of four related dream symbols: hand-picked links first, then the most similar symbols by category, themes and meaning. Every slug exists in the catalogue; links are reciprocal.

## Other responses

- `401`: Authentication failed
- `403`: Authorization failed
- `404`: Resource not found
- `413`: Payload too large
- `422`: Validation error
- `429`: Rate limit exceeded
- `500`: Internal error
- `502`: Upstream provider error
- `503`: Service unavailable

---

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