title: Date Alignment Check API Endpoint description: Developer documentation for the Date Alignment Check endpoint in The Numerology API: date compatibility scoring for life decisions, request parameter options, authentication, multilingual JSON responses, and production-ready examples. Extended endpoints are available only on the direct Numerology API platform (RapidAPI gateway not supported).
Date Alignment Check¶
The Date Alignment Check endpoint returns enterprise numerology output for date compatibility scoring for life decisions. Use this page for integration-ready parameter rules, allowed options, and response examples.
Endpoint¶
| Method | Path |
|---|---|
GET | https://api.numerologyapi.com/api/v1/date-alignment-check |
POST | https://api.numerologyapi.com/api/v1/date-alignment-check |
Availability¶
- Authentication:
X-API-Key(orAuthorization: Bearer YOUR_API_KEY) - Supported
langvalues:en,fr,es,de,pt,ja,hi,ar,ru,tr,it,pl,nl,id,ko,th,ro,ur,gu,bn,vi,ta,te,mr,pa,zh - Access channel: direct API (
https://api.numerologyapi.com) - RapidAPI gateway: Not currently supported for extended endpoints
Parameters¶
GET Query Parameters¶
| Parameter | Type | Required | Default | Options | Description |
|---|---|---|---|---|---|
dob | string | Yes | — | pattern ^\d{4}-\d{2}-\d{2}$ | Date of birth in YYYY-MM-DD format |
target_date | string | Yes | — | pattern ^\d{4}-\d{2}-\d{2}$ | Decision date to evaluate in YYYY-MM-DD format |
context | string | Yes | — | length 1..80; canonical: marriage, launch, travel, interview, move, contract, surgery, exam, meeting; aliases accepted (examples): wedding, engagement, trip, vacation, test, presentation, negotiation | Context such as marriage, launch, travel, interview, move, contract, surgery, exam, meeting |
lang | string | No | en | en, fr, es, de, pt, ja, hi, ar, ru, tr, it, pl, nl, id, ko, th, ro, ur, gu, bn, vi, ta, te, mr, pa, zh | Response language (supported: en, fr, es, de, pt, ja, hi, ar, ru, tr, it, pl, nl, id, ko, th, ro, ur, gu, bn, vi, ta, te, mr, pa, zh) |
POST Query Parameters¶
| Parameter | Type | Required | Default | Options | Description |
|---|---|---|---|---|---|
lang | string | No | en | en, fr, es, de, pt, ja, hi, ar, ru, tr, it, pl, nl, id, ko, th, ro, ur, gu, bn, vi, ta, te, mr, pa, zh | Response language (supported: en, fr, es, de, pt, ja, hi, ar, ru, tr, it, pl, nl, id, ko, th, ro, ur, gu, bn, vi, ta, te, mr, pa, zh) |
POST Body Parameters¶
| Parameter | Type | Required | Default | Options | Description |
|---|---|---|---|---|---|
dob | string | Yes | — | pattern ^\d{4}-\d{2}-\d{2}$ | Date of birth in YYYY-MM-DD format. |
target_date | string | Yes | — | pattern ^\d{4}-\d{2}-\d{2}$ | Target date in YYYY-MM-DD format. |
context | string | Yes | — | length 1..80; canonical: marriage, launch, travel, interview, move, contract, surgery, exam, meeting; aliases accepted: wedding, engagement, trip, vacation, test, presentation, negotiation | Context to evaluate (for example exam, marriage, launch, travel). |
Response Example¶
Response Example
{
"dob": "1992-07-16",
"target_date": "1992-07-16",
"context": "test",
"normalized_context": "exam",
"alignment_score": 76,
"alignment_label": "Supportive Alignment",
"recommendation": "Generally supportive, though intentional preparation still matters.",
"numbers": {
"life_path_number": 8,
"personal_year_number": 8,
"personal_month_number": 6,
"personal_day_number": 22,
"universal_year_number": 3,
"universal_month_number": 1,
"universal_day_number": 8,
"day_of_month_number": 7
},
"component_scores": {
"personal_day": 20,
"personal_month": 4,
"personal_year": 8,
"universal_day": 16,
"universal_month": 6,
"day_of_month": 10,
"life_path_bridge": 4,
"master_support": 8
},
"context_profile": {
"favored_numbers": [
3,
4,
7,
8,
11
],
"caution_numbers": [
5,
6,
9
],
"best_vibes": [
"focus",
"clarity",
"memory",
"precision",
"mental discipline"
]
},
"strengths": [
"Universal Day is favorable for collective timing",
"Personal Year aligns with the deeper phase of life",
"Master Number support adds amplified spiritual significance"
],
"cautions": [
"No major caution pattern dominates, but preparation still matters"
],
"meaning": {
"title": "Exam Date: Supportive Alignment",
"overview": "This date is reasonably supportive for exams. It is workable and useful when paired with preparation and calm pacing.",
"core_message": "A supportive exam date with practical effort.",
"why_this_can_work": [
"The day is generally compatible with focused mental effort",
"There is enough steadiness and clarity for solid performance",
"The timing supports reasonable concentration and recall",
"It allows your preparation to shine through effectively"
],
"best_used_for": [
"Regular academic exams and coursework tests",
"Study assessments and practice evaluations",
"Moderate-pressure examinations",
"Routine testing and certifications"
],
"energetic_advantages": [
"Usable focus and mental support",
"Balanced steadiness for performance",
"Helpful clarity during the exam process",
"Supports calm pacing and reasonable retention"
],
"watch_out": [
"Stay well organized and avoid last-minute pressure",
"Do not rely on timing alone — consistent preparation is still vital",
"Manage overthinking or anxiety through grounding techniques",
"Ensure good sleep and nutrition before the exam"
],
"guidance": "Good enough timing to perform well when supported by solid preparation and calm focus.",
"affirmation": "I trust my preparation and move with calm focus, clarity, and confidence."
},
"detailed_meaning": "This date carries a steady, grounded energy for an exam, suggesting a fair testing experience where consistent study meets standard performance. Success will come through careful reading, methodical answering, and managing time without rushing. The timing is reliable, favoring thoroughness over speed and accuracy over guesswork. Proceed with calm focus, skip and return to difficult questions, and trust that diligent preparation will be reflected in your results. The universe supports your diligence, but expects you to stay present and attentive throughout.",
"_enterprise": {
"client": "The Numerology API",
"plan": "Enterprise",
"request_id": "114acaf81744c451",
"quota": "unlimited",
"usage_tracking": true,
"decision_api": true
},
"_api_metadata_": {
"api_name": "The Numerology API by Dakidarts®",
"api_version": "1.0.2",
"endpoint_name": "date_alignment_check",
"endpoint_description": "Evaluates how aligned a target date is for a specific life context using personal and universal numerology cycles.",
"developer": "Dakidarts®",
"copyright": "© 2026 Dakidarts®. All rights reserved.",
"documentation_url": "https://docs.numerologyapi.com/",
"response_timestamp": "2026-08-17T17:53:27.799076+01:00",
"data_source": "Internal Engine",
"cacheable_status": true,
"report_issue": "https://github.com/dakidarts/the-numerology-api/issues",
"response_language": "en",
"supported_languages": [
"en",
"fr",
"es",
"de",
"pt",
"ja",
"hi",
"ar",
"ru",
"tr",
"it",
"pl",
"nl",
"id",
"ko",
"th",
"ro",
"ur",
"gu",
"bn",
"vi",
"ta",
"te",
"mr",
"pa",
"zh"
],
"notes": ""
}
}
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.