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.

Endpoint

GET /v1/numerology/meaning/{number}

Request parameters

Field	Type	Required	Description
number	integer	Yes
context	string	No	Interpretation family. `general` defaults to life_path meanings; other values select that specific table.

Example request

curl
Python
TypeScript

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

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)

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);

Example response

{
  "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
  }
}

Response fields

Field	Type	Description
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

Code	Description	Reference
authentication_failed	Missing or invalid API key.	authentication_failed
ephemeris_unavailable	Upstream ephemeris service error.	ephemeris_unavailable
insufficient_tier	API key tier does not include this endpoint.	insufficient_tier
internal_error	Unexpected server error.	internal_error
ip_rate_limit_exceeded	Too many requests in a short window.	ip_rate_limit_exceeded
payload_too_large	Request body exceeds the size limit.	payload_too_large
resource_not_found	Referenced resource was not found.	resource_not_found
validation_error	Request body failed schema validation.	validation_error

Endpoint​

Request parameters​

Example request​

Example response​

Response fields​

Errors​

Related endpoints​