Skip to main content

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.

Endpoint

GET /v1/dreams/symbols

Request parameters

FieldTypeRequiredDescription
categorystring | nullNoFilter by category: animals, nature, people, places, objects, actions, body, abstract.

Example request

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

Example response

{
"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": [
"peasant",
"procession",
"... 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": [
"lizard",
"merchant",
"... and 2 more items"
]
},
"... and 78 more items"
]
}
}

Response fields

FieldTypeDescription
successbooleanTrue if the request succeeded
messagestringHuman-readable status message
dataobject
data.totalintegerTotal number of symbols returned.
data.category_filterstring | nullCategory filter applied, if any.
data.symbolsarray[object]Dream symbols sorted alphabetically.
data.symbols[].slugstringURL-safe identifier.
data.symbols[].namestringDisplay name of the symbol.
data.symbols[].categorystringSymbol category: animals, nature, people, places, objects, actions, body, or abstract.
data.symbols[].jungian_meaningstringJungian/Western psychological interpretation.
data.symbols[].jungian_archetypestringPrimary Jungian archetype activated by this symbol.
data.symbols[].vedic_meaningstringClassical Vedic dream tradition interpretation.
data.symbols[].vedic_auspiciousboolean | nullTrue if auspicious (Shubha), False if inauspicious (Ashubha), null if mixed/context-dependent.
data.symbols[].traditions_agreestringWhether Jungian and Vedic traditions agree: 'agree', 'conflict', or 'partial'.
data.symbols[].emotional_tonestringPrimary emotional register: anxiety, transformation, auspicious, warning, grief, power, healing, clarity, confusion, or neutral.
data.symbols[].themesarray[string]Thematic keywords used for AI synthesis and search.
data.symbols[].context_variantsarray[object]Alternative readings depending on dream context.
data.symbols[].context_variants[].contextstringThe specific dream context or variant.
data.symbols[].context_variants[].meaningstringThe interpretation for this specific context.
data.symbols[].related_symbolsarray[string]Slugs of related dream symbols.

Errors

CodeDescriptionReference
authentication_failedMissing or invalid API key.authentication_failed
ephemeris_unavailableUpstream ephemeris service error.ephemeris_unavailable
insufficient_tierAPI key tier does not include this endpoint.insufficient_tier
internal_errorUnexpected server error.internal_error
ip_rate_limit_exceededToo many requests in a short window.ip_rate_limit_exceeded
payload_too_largeRequest body exceeds the size limit.payload_too_large
resource_not_foundReferenced resource was not found.resource_not_found
validation_errorRequest body failed schema validation.validation_error