GET/v1/dreams/symbols

Dream symbol database

Returns all dream symbols from the database, optionally filtered by category. Each symbol includes dual-tradition interpretation: Jungian/Western psychological analysis and classical Vedic dream tradition meaning with auspiciousness rating. The traditions_agree field flags where Western and Vedic interpretations conflict. Categories: animals, nature, people, places, objects, actions, body, abstract.

Request parameters

categoryoptional

string | null

Filter by category: animals, nature, people, places, objects, actions, body, abstract.

Response fields

success

boolean

True if the request succeeded

message

string

Human-readable status message

data

object

data.total

integer

Total number of symbols returned.

data.category_filter

string | null

Category filter applied, if any.

data.symbols

array[object]

Dream symbols sorted alphabetically.

data.symbols[].slug

string

URL-safe identifier.

data.symbols[].name

string

Display name of the symbol.

data.symbols[].category

string

Symbol category: animals, nature, people, places, objects, actions, body, or abstract.

data.symbols[].jungian_meaning

string

Jungian/Western psychological interpretation.

data.symbols[].jungian_archetype

string

Primary Jungian archetype activated by this symbol.

data.symbols[].vedic_meaning

string

Classical Vedic dream tradition interpretation.

data.symbols[].vedic_auspicious

boolean | null

True if auspicious (Shubha), False if inauspicious (Ashubha), null if mixed/context-dependent.

data.symbols[].traditions_agree

string

Whether Jungian and Vedic traditions agree: 'agree', 'conflict', or 'partial'.

data.symbols[].emotional_tone

string

Primary emotional register: anxiety, transformation, auspicious, warning, grief, power, healing, clarity, confusion, or neutral.

data.symbols[].themes

array[string]

Thematic keywords used for AI synthesis and search.

data.symbols[].context_variants

array[object]

Alternative readings depending on dream context.

data.symbols[].context_variants[].context

string

The specific dream context or variant.

data.symbols[].context_variants[].meaning

string

The interpretation for this specific context.

data.symbols[].related_symbols

array[string]

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.

Errors

api_key_invalid

Invalid API key format.

api_key_missing

API key is missing. Include it in the Authorization header as 'Bearer YOUR_KEY'.

api_key_not_found

The provided API key was not found. Verify the key in your Asterwise dashboard.

api_key_revoked

This API key has been revoked.

burst_limit_exceeded

Too many requests per minute. Please slow down.

internal_error

Something went wrong on our end. Please try again, or contact [email protected] if the problem persists. Include your request_id when contacting support.

ip_rate_limit_exceeded

Too many requests from this IP address. Please slow down.

monthly_usage_limit_exceeded

Monthly API call limit reached. Upgrade your plan to continue.

payload_too_large

Request body exceeds maximum allowed size of 64KB.

subscription_expired

Your subscription has expired. Please renew at asterwise.com/dashboard to continue.

validation_error

The request couldn't be processed. See the 'details' field for specific field-level issues.

Related endpoints

• Single dream symbol lookup

Request

GET·application/json

curl

curl -X GET "https://api.asterwise.com/v1/dreams/symbols?category=animals" \
  -H "Authorization: Bearer YOUR_API_KEY"

Python

import asterwise
from asterwise.api.dreams_api import DreamsApi

configuration = asterwise.Configuration(
    host="https://api.asterwise.com",
    access_token="YOUR_API_KEY",
)

with asterwise.ApiClient(configuration) as client:
    api = DreamsApi(client)
    result = api.dream_symbols(category="animals")
    print(result)

TypeScript

import { createClient, createConfig, dreamSymbols } from 'asterwise';

const client = createClient(createConfig({
  baseUrl: 'https://api.asterwise.com',
  headers: { Authorization: 'Bearer YOUR_API_KEY' },
}));

const result = await dreamSymbols({
  client,
  query: {
      "category": "animals"
  },
});

console.log(result.data);

Response

200 OK·application/jsonsigned

{
  "success": true,
  "message": "success",
  "data": {
    "total": 80,
    "category_filter": "animals",
    "symbols": [
      {
        "slug": "badger",
        "name": "Badger",
        "category": "animals",
        "jungian_meaning": "As a animals symbol, 'Badger' condenses personal associations into one charged image; track movement (toward/away), colo…",
        "jungian_archetype": "Shadow",
        "vedic_meaning": "Classical Swapna texts read 'Badger' through directional and luminosity cues — auspiciousness shifts with colour, compan…",
        "vedic_auspicious": true,
        "traditions_agree": "agree",
        "emotional_tone": "warning",
        "themes": [
          "badger",
          "animals",
          "... and 2 more items"
        ],
        "context_variants": [
          {
            "context": "Badger vivid and near",
            "meaning": "The motif presses for emotional clarity — notice whether attraction or repulsion dominates the scene."
          },
          {
            "context": "Badger distant or faded",
            "meaning": "Material not yet constellated; repeat dreams may amplify it until integrated."
          },
          "... and 1 more item"
        ],
        "related_symbols": [
          "goat",
          "mouse",
          "... and 2 more items"
        ]
      },
      {
        "slug": "bat",
        "name": "Bat",
        "category": "animals",
        "jungian_meaning": "As a animals symbol, 'Bat' condenses personal associations into one charged image; track movement (toward/away), colour,…",
        "jungian_archetype": "Anima",
        "vedic_meaning": "Classical Swapna texts read 'Bat' through directional and luminosity cues — auspiciousness shifts with colour, companion…",
        "vedic_auspicious": false,
        "traditions_agree": "conflict",
        "emotional_tone": "auspicious",
        "themes": [
          "bat",
          "animals",
          "... and 3 more items"
        ],
        "context_variants": [
          {
            "context": "Bat vivid and near",
            "meaning": "The motif presses for emotional clarity — notice whether attraction or repulsion dominates the scene."
          },
          {
            "context": "Bat distant or faded",
            "meaning": "Material not yet constellated; repeat dreams may amplify it until integrated."
          },
          "... and 1 more item"
        ],
        "related_symbols": [
          "frog",
          "rat",
          "... and 2 more items"
        ]
      },
      "... and 78 more items"
    ]
  }
}