🕰️ 15+ Muhurta APIs and ✋ Palmistry API are now live. Ship them in your app today.

Luck Reading

You must provide a valid face_id to call this API. How to get Face ID →
Luck Reading API interprets the stored face-reading features for opportunity patterns, favorable tendencies, support, timing themes, and the traditional idea of fortune visible through the face.

The reading is generated from the complete stored feature set rather than from a fresh image scan. This allows the result to combine structural features, facial balance, traditional Palaces, and other detected observations into one luck-focused interpretation.

This API provides the dedicated fortune and opportunity section of the overall Face Reading experience.
POSThttps://vision.astrologyapi.com/face-reading/luck

Authentication

x-astrologyapi-keystringrequired

API access token used to authenticate requests. Send your access token in this custom header.

Accept-Languagestring

Preferred language for the response content. Supported: English - en.

Body parameters

face_idstringrequired

Unique face reading ID returned by get-face-id

Get a luck category reading for a previously scanned face.
← Previous
Love Reading
Next →
Marriage Reading
curl --location 'https://vision.astrologyapi.com/face-reading/luck' \
  --header 'Content-Type: application/json' \
  --header 'x-astrologyapi-key: <YOUR_ACCESS_TOKEN>' \
  --data '{
    "face_id": "c48d0b80-1d49-4af8-8c05-e778b3d7a00f"
}'
Try it

Runs with sample data — no API key needed

{
  "status": true,
  "data": {
    "overall_fortune": "The overall flow of luck is positive and harmonious, supported by a healthy qi luster and strong facial symmetry, suggesting a life of relative stability and balanced energy.",
    "fortune_gate": "The smooth and bright Yin Tang indicates an open gate of fortune, suggesting that opportunities flow naturally and luck is readily accessible without excessive struggle.",
    "life_stages": {
      "early_life": "The short upper court suggests a period of rapid growth or a youth where fortune was modest or required more effort to establish.",
      "mid_life": "The balanced middle court indicates a period of steady progress, stability, and a harmonious integration of professional and personal life.",
      "later_life": "The long lower court points toward a prosperous and fulfilling later life, suggesting that fortune accumulates and peaks in the senior years."
    },
    "auspicious_marks": [
      {
        "location": "earring on right ear lobe",
        "meaning": "Adornments on the ear lobes are often associated with an increase in social status, wealth, and the ability to listen to wise counsel."
      }
    ],
    "peak_periods": "Later life (51+), as the dominant lower court suggests the strongest accumulation of wealth and stability.",
    "lucky_strengths": [
      "Openness to opportunity due to a bright Life Palace",
      "Strong late-life resilience and prosperity from a developed lower court"
    ],
    "summary": "The subject's fortune follows an ascending trajectory, moving from a modest youth toward a highly prosperous and stable later life. With an open gate of fortune and healthy qi, they are well-positioned to attract success through a balanced and harmonious life flow."
  }
}