GET/v1/numerology/meaning/{number}

Get number meaning by context

Returns interpretation details for a specific number within a numerology context. Query context defaults to general (same meanings as life path). Requires authenticated API key access (Core tier or above in product terms). Returns meaning text and optional thematic guidance fields.

Request parameters

numberrequired

integer

contextoptional

string

Interpretation family. general defaults to life_path meanings; other values select that specific table.

Response fields

success

boolean

True if the request succeeded

message

string

Human-readable status message

data

object

data.number

integer

Number being interpreted

data.context

string

Numerology context for interpretation (general uses life_path meanings)

data.interpretation

string

Narrative meaning for the number in context

data.keywords

array[string]

Keywords for number-context meaning

data.theme

string | null

Optional theme label for this meaning

data.opportunities

array[string]

Opportunity highlights for this meaning

data.challenges

array[string]

Challenge highlights for this meaning

data.advice

string | null

Optional advice associated with this meaning

Errors

authentication_failed

Missing or invalid API key.

ephemeris_unavailable

Upstream ephemeris service error.

insufficient_tier

API key tier does not include this endpoint.

internal_error

Unexpected server error.

ip_rate_limit_exceeded

Too many requests in a short window.

payload_too_large

Request body exceeds the size limit.

resource_not_found

Referenced resource was not found.

validation_error

Request body failed schema validation.

Related endpoints

• Generate lucky numbers
• Name Correction Analysis
• Calculate numerology compatibility

Request

GET·application/json

curl

curl -X GET "https://api.asterwise.com/v1/numerology/meaning/7?context=general" \
  -H "Authorization: Bearer YOUR_API_KEY"

Python

import asterwise
from asterwise.api.numerology_api import NumerologyApi

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

with asterwise.ApiClient(configuration) as client:
    api = NumerologyApi(client)
    result = api.number_meaning(context="general",
    number=7)
    print(result)

TypeScript

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

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

const result = await numberMeaning({
  client,
  query: {
      "context": "general"
  },
  path: {
      "number": 7
  },
});

console.log(result.data);

Response

200 OK·application/jsonsigned

{
  "success": true,
  "message": "success",
  "data": {
    "number": 7,
    "context": "general",
    "interpretation": "You are the seeker of truth and wisdom. Your life purpose involves spiritual growth, analysis, and understanding life's…",
    "keywords": [
      "Spirituality",
      "Analysis",
      "... and 3 more items"
    ],
    "theme": null,
    "opportunities": [],
    "challenges": [],
    "advice": null
  }
}