Skip to content

title: "Decision Crossroads Reading" description: Developer documentation for the Decision Crossroads Reading endpoint in The Numerology API: option comparison against a birth profile and target date with numerological alignment scoring, request parameter options, authentication, multilingual JSON responses, numerology system support, and production-ready examples. Extended endpoints are available only on the direct Numerology API platform (RapidAPI gateway not supported).

Decision Crossroads Reading

The Decision Crossroads Reading endpoint compares up to five options against a user birth profile and target date, then returns ranked decision alignment. Use this page for integration-ready parameter rules, allowed options, and response examples.

Endpoint

Method Path
GET https://api.numerologyapi.com/api/v1/decision-crossroads-reading
POST https://api.numerologyapi.com/api/v1/decision-crossroads-reading

Availability

  • Authentication: X-API-Key (or Authorization: Bearer YOUR_API_KEY)
  • Supported lang values: en, es, de, fr, pt, ar, hi, ja
  • Access channel: direct API (https://api.numerologyapi.com)
  • RapidAPI gateway: Not currently supported for extended endpoints
  • Optional numerology systems: pythagorean, chaldean, vedic (pythagorean is the default)

Parameters

GET Query Parameters

Parameter Type Required Default Options Description
full_name string Yes — length 1..160 Full name
dob string Yes — YYYY-MM-DD Date of birth
decision_context string Yes — length 1..300 Decision context
options array[string] Yes — repeat query parameter; 2..5 options Options to compare
target_date string Yes — YYYY-MM-DD Target date
num_sys string No pythagorean pythagorean, chaldean, vedic Numerology system used for name calculations
lang string No en en, es, de, fr, pt, ar, hi, ja Response language

POST Query Parameters

Parameter Type Required Default Options Description
lang string No en en, es, de, fr, pt, ar, hi, ja Response language

POST Body Parameters

Parameter Type Required Default Options Description
full_name string Yes — length 1..160 Full name
dob string Yes — YYYY-MM-DD Date of birth
decision_context string Yes — length 1..300 Decision context
options array[string] Yes — 2..5 options Options to compare
target_date string Yes — YYYY-MM-DD Target date
num_sys string No pythagorean pythagorean, chaldean, vedic Numerology system used for name calculations

Request Examples

GET

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.numerologyapi.com/api/v1/decision-crossroads-reading?full_name=Mira%20Chen&dob=1994-06-18&decision_context=Which%20project%20next&options=Launch%20API%20v2&options=Hire%20sales%20lead&target_date=2026-08-01&lang=en"

POST

curl -X POST "https://api.numerologyapi.com/api/v1/decision-crossroads-reading?lang=en" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "full_name": "Mira Chen",
  "dob": "1994-06-18",
  "decision_context": "Which project should I prioritize next quarter?",
  "options": ["Launch API v2", "Hire sales lead", "Build mobile app"],
  "target_date": "2026-08-01",
  "num_sys": "pythagorean"
}'

POST Body Example

{
  "full_name": "Mira Chen",
  "dob": "1994-06-18",
  "decision_context": "Which project should I prioritize next quarter?",
  "options": ["Launch API v2", "Hire sales lead", "Build mobile app"],
  "target_date": "2026-08-01",
  "num_sys": "pythagorean"
}

Response Highlights

  • recommended_option
  • options[].option_alignment_score
  • options[].alignment_band
  • risk_number
  • momentum_number
  • personal_day_number
  • universal_day_number
  • meaning

Response Example

{
  "numerology_system": "pythagorean",
  "recommended_option": "Launch API v2",
  "personal_day_number": 4,
  "universal_day_number": 1,
  "options": [
    {
      "option": "Launch API v2",
      "option_name_number": 8,
      "option_alignment_score": 86,
      "alignment_band": "high_alignment",
      "meaning": { "title": "Green-Light Alignment", "overview": "..." }
    }
  ]
}

Open Dashboard

Note

This endpoint belongs to the Extended suite and is available through direct API access at https://api.numerologyapi.com. It is currently not supported via the RapidAPI gateway.