---
title: "Generate lucky numbers"
method: POST
path: "/v1/numerology/lucky-numbers"
tags: ["Numerology"]
---

# Generate lucky numbers

`POST /v1/numerology/lucky-numbers`

## Request

- Base URL: `https://api.asterwise.com`
- URL: `https://api.asterwise.com/v1/numerology/lucky-numbers`
- Auth: HTTP bearer

Generates a deterministic lucky number set from `name` and `date` in the JSON body (BirthInput-aligned), with optional `count` (1-20, default 6). Returns lucky numbers with supporting numerology context.

## Request body

- LuckyNumbersRequest: POST body for lucky numbers: name and birth date stay out of the URL.
  - `name` string, required: Person name
  - `date` string, date, required: Birth date (YYYY-MM-DD)
  - `count` integer: How many lucky numbers to return

## Response `200`

Lucky number list for the requested profile

- ApiResponseLuckyNumbersApiResponse
  - `success` boolean: True if the request succeeded
  - `message` string: Human-readable status message
  - `data` LuckyNumbersApiResponse, required
    - `lucky_numbers` integer[], required: Lucky numbers, no repeats: first the Life Path, Expression, Soul Urge, Personality and Birth Day (these may be master numbers 11, 22, 33), then digits 1-9 from the birth date in ascending order, topped up with unused digits 1-9 (at most 9 are guaranteed)
    - `power_number` integer, required: Most powerful number for the person
    - `date_specific` boolean: Whether numbers are specific to a date
    - `interpretation` string, required: How to use these numbers

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