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 (or Authorization: Bearer YOUR_API_KEY)
Supported lang values: en, es, de, fr, pt
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`, `es`, `de`, `fr`, `pt`	Response language (supported: en, es, de, fr, pt)

POST Query Parameters¶

Parameter	Type	Required	Default	Options	Description
`lang`	`string`	No	`en`	`en`, `es`, `de`, `fr`, `pt`	Response language (supported: en, es, de, fr, pt)

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¶

GET¶

{
  "dob": "1992-07-16",
  "target_date": "2026-02-27",
  "context": "test",
  "normalized_context": "exam",
  "alignment_score": 82,
  "alignment_label": "Strong Alignment",
  "recommendation": "Good date with strong supportive energy.",
  "numbers": {
    "life_path_number": 8,
    "personal_year_number": 6,
    "personal_month_number": 8,
    "personal_day_number": 8,
    "universal_year_number": 1,
    "universal_month_number": 3,
    "universal_day_number": 3,
    "day_of_month_number": 9
  },
  "component_scores": {
    "personal_day": 22,
    "personal_month": 10,
    "personal_year": 3,
    "universal_day": 16,
    "universal_month": 8,
    "day_of_month": 4,
    "life_path_bridge": 14,
    "master_support": 5
  },
  "context_profile": {
    "favored_numbers": [
      3,
      4,
      7,
      8,
      11
    ],
    "caution_numbers": [
      5,
      6,
      9
    ],
    "best_vibes": [
      "focus",
      "clarity",
      "memory",
      "precision",
      "mental discipline"
    ]
  },
  "strengths": [
    "Personal Day strongly supports the chosen context",
    "Universal Day is favorable for collective timing",
    "Personal Month supports the broader timing window"
  ],
  "cautions": [
    "Day-of-month vibration may amplify less favorable themes"
  ],
  "meaning": {
    "title": "Exam Date: Strong Alignment",
    "overview": "A strong and supportive date for exams or mentally demanding evaluation.",
    "core_message": "A very good date for exams and focused performance.",
    "why_this_is_supportive": [
      "The timing supports strong concentration and good mental pacing",
      "It favors organized thinking, retention, and disciplined effort",
      "The energy helps maintain composure under pressure",
      "Recognition and clear expression of knowledge feel naturally supported"
    ],
    "best_used_for": [
      "Important academic exams and tests",
      "Professional evaluations and assessments",
      "Certifications and qualifying examinations",
      "Performance situations requiring mental focus"
    ],
    "energetic_advantages": [
      "Reliable focus and mental steadiness",
      "Good support for organized thinking and pacing",
      "Helpful energetic rhythm for sustained effort",
      "Favors calm delivery and clear recall"
    ],
    "watch_out": [
      "Preparation and consistent revision still matter more than timing alone",
      "Do not rely solely on the date — thorough study is key",
      "Ensure adequate rest and stress management",
      "Avoid last-minute cramming despite favorable energy"
    ],
    "guidance": "A strong day to demonstrate what you know. Combine the supportive timing with disciplined preparation and calm presence.",
    "affirmation": "I show up focused, prepared, composed, and confident."
  },
  "detailed_meaning": "This date offers favorable and focused energy for an exam, indicating a high likelihood of performing well and accessing your knowledge effectively. The timing supports concentration, logical reasoning, and managing time wisely. Minor nerves or tricky questions may arise, but the overall vibration supports your ability to navigate them with poise. Proceed with confidence in your preparation, read questions carefully, and trust your first instincts. The universe encourages your effort, providing mental clarity for a successful outcome.",
  "_enterprise": {
    "client": "The Numerology API",
    "plan": "Enterprise",
    "request_id": "d82a9455b5aeecfa",
    "quota": "unlimited",
    "usage_tracking": true,
    "decision_api": true
  },
  "_api_metadata_": {
    "api_name": "The Numerology API by Dakidarts®",
    "api_version": "1.0.0",
    "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-03-28T14:37:50.345362+01:00",
    "data_source": "Internal Engine / Astro Numerology Interpretation Engine (ANIE)",
    "cacheable_status": true,
    "report_issue": "https://github.com/dakidarts/the-numerology-api/issues",
    "response_language": "en",
    "supported_languages": [
      "en",
      "es",
      "de",
      "fr",
      "pt"
    ],
    "notes": ""
  }
}

¶

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.