---
title: "Muhurtham dates for registration"
method: POST
path: "/api/v1/tools/muhurtham_dates"
---

# Muhurtham dates for registration

`POST /api/v1/tools/muhurtham_dates`

## Request

- Base URL: `https://verified.realestate`
- URL: `https://verified.realestate/api/v1/tools/muhurtham_dates`
- Auth: HTTP bearer

List the published muhurtham (auspicious) dates in a date window from the Tamil calendar, with each date's details: Tamil month and day (Tamil script plus transliteration), weekday, valarpirai/theipirai type, nakshatram, auspicious score, SRO and bank open/closed status, good time and raahu kaalam windows, and what the day suits or should avoid. Use for "good date to register my property", "muhurtham for griha pravesham / housewarming / bhoomi puja", "nalla naal this month". Defaults to the next 60 days when no dates are given; the window is capped at 120 days. Muhurtham selection is customary guidance, not a legal requirement. Costs 1 credit per call, waived when nothing is found.

## Request body

- object
  - `start_date` string: Window start, YYYY-MM-DD. Defaults to today.
  - `end_date` string: Window end, YYYY-MM-DD. Defaults to start_date + 60 days. Windows longer than 120 days are clamped.
  - `purpose` string: Optional purpose, e.g. property registration, griha pravesham / housewarming, bhoomi puja, token advance. Echoed back; match it against each date's suitable_for / avoid_for lists.

## Response `200`

The envelope: ok, status, data, credits_charged, balance_after, request_id

## Other responses

- `401`: No valid credential
- `402`: Not enough credits
- `429`: Rate limit

---

[API](https://skmtc.dev/verified/apis/landlens-tool-api.md) · [All operations](https://skmtc.dev/verified/apis/landlens-tool-api/llms.txt) · [OpenAPI document](https://skmtc.dev/verified/apis/landlens-tool-api/revisions/7923c1c24431?raw)