---
title: "Get number meaning by context"
method: GET
path: "/v1/numerology/meaning/{number}"
tags: ["Numerology"]
---

# Get number meaning by context

`GET /v1/numerology/meaning/{number}`

## Request

- Base URL: `https://api.asterwise.com`
- URL: `https://api.asterwise.com/v1/numerology/meaning/{number}`
- Auth: HTTP bearer

Returns interpretation details for a specific number within a numerology context. Query `context` defaults to `general` (same meanings as life path). Allowed numbers: 1-9, 11, 22 and 33 for general, life_path, expression, soul_urge and personality; 1-9 for birth_day (a master Birth Day 11 or 22 in a profile uses the 2 or 4 text) and personal_year. Any other number answers 422 `validation_error` with the allowed values in `details`. Returns meaning text and optional thematic guidance fields.

## Path parameters

- `number` integer, required

## Query parameters

- `context` 'general' | 'life_path' | 'expression' | 'soul_urge' | 'personality' | 'birth_day' | 'personal_year': Interpretation family. `general` defaults to life_path meanings; other values select that specific table.

## Response `200`

Interpretation details for number and context

- ApiResponseNumberMeaningResponse
  - `success` boolean: True if the request succeeded
  - `message` string: Human-readable status message
  - `data` NumberMeaningResponse, required
    - `number` integer, required: Number being interpreted
    - `context` 'general' | 'life_path' | 'expression' | 'soul_urge' | 'personality' | 'birth_day' | 'personal_year', required: Numerology context for interpretation (`general` uses life_path meanings)
    - `interpretation` string, required: Narrative meaning for the number in context
    - `keywords` string[]: Keywords for number-context meaning
    - `theme` string, nullable: Optional theme label for this meaning
    - `opportunities` string[]: Opportunity highlights for this meaning
    - `challenges` string[]: Challenge highlights for this meaning
    - `advice` string, nullable: Optional advice associated with this meaning

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