Transport
Use HTTPS. Public endpoints currently accept GET; HEAD is documented for header-only checks. JSON uses UTF-8.
Complete reference · 35 APIs
API Documentation
Request conventions, parameter definitions, caching and freshness rules, errors, examples and endpoint-level reference.
Base URL and first request
Base URL
https://astro.sindhilanguage.org/api/MethodGET / HEAD
AuthenticationNo API key
Default timezoneAsia/Karachi
cURL
curl -sS "https://astro.sindhilanguage.org/api/system-health.php"HTTP, caching and freshness
Coordinates
Latitude and longitude use decimal degrees. Latitude range is −90…90; longitude is −180…180.
Timezone
Use an IANA identifier such as Asia/Karachi or UTC. Endpoint defaults are documented below.
Cache semantics
Respect Cache-Control, ETag and optional X-Data-Valid-Until. Do not retain date-bearing data beyond its validity.
Rate limits
Cloudflare and application limits protect the public service. Cache responses and avoid high-frequency polling.
Maturity
Stable is operational; Research is production-accessible with validation continuing; Validation exposes comparison/audit work.
JSON and errors
Response fields vary by engine. Most services expose an ok or success flag, endpoint-specific data, source metadata and a freshness envelope.
Typical success
{
"success": true,
"data": { ... },
"freshness": {
"generated_at": "2026-07-11T17:11:00+05:00",
"valid_until": "2026-07-11T17:12:00+05:00",
"is_stale": false
}
}Typical error
{
"ok": false,
"error": {
"code": "invalid_parameter",
"message": "Invalid request parameter."
}
}200Successful response
304ETag matched; use cached body
400Invalid or missing parameter
429Rate limit exceeded
503Fresh live data unavailable
All public endpoints
Search by name, URL, category or capability.
Platform & Integration
Discovery, health, daily public feeds and integrated observatory payloads.
Machine-readable catalogue of every public API, category, parameter, example and documentation link.
/api/directory.json.phpRun →No query parameters.
Public liveness and freshness signal for the API, Live Sky snapshot and reference snapshot.
/api/system-health.phpRun →No query parameters.
Aggregated solar, lunar and observer calculations for a supplied instant and location.
/api/phase-015.php?datetime=2026-03-20T10:00:00&lat=25.396&lon=68.3578&timezone=Asia/KarachiRun →ParameterTypeRequiredDescription
datetimestringNoISO-8601 datetime or nowlatnumberNoObserver latitude Default: 25.396lonnumberNoObserver longitude Default: 68.3578timezonestringNoIANA timezone Default: Asia/KarachiDaily astronomy integration layer with source metadata and NASA/JPL alignment targets.
/api/phase-016.php?date=2026-07-11&lat=25.396&lon=68.3578&timezone=Asia/KarachiRun →ParameterTypeRequiredDescription
datestringNoGregorian date YYYY-MM-DD or today Default: todaylatnumberNoObserver latitude Default: 25.396lonnumberNoObserver longitude Default: 68.3578timezonestringNoIANA timezone Default: Asia/KarachiProduction observatory payload combining calendar, solar, lunar, season and reference status.
/api/phase-017.php?date=2026-07-11&lat=25.396&lon=68.3578&timezone=Asia/KarachiRun →ParameterTypeRequiredDescription
datestringNoGregorian date YYYY-MM-DD or today Default: todaylatnumberNoObserver latitude Default: 25.396lonnumberNoObserver longitude Default: 68.3578timezonestringNoIANA timezone Default: Asia/KarachiPublic-facing daily observatory feed designed for websites, apps and widgets.
/api/public-observatory.php?date=2026-07-11&lat=25.396&lon=68.3578&timezone=Asia/KarachiRun →ParameterTypeRequiredDescription
datestringNoGregorian date YYYY-MM-DD or today Default: todaylatnumberNoObserver latitude Default: 25.396lonnumberNoObserver longitude Default: 68.3578timezonestringNoIANA timezone Default: Asia/KarachiSolar & Seasons
Sun position, daylight, equinox and Sindhi season calculations.
Apparent solar longitude, right ascension, declination, equation of time and Earth–Sun distance.
/api/solar-position.php?datetime=2026-03-20T10:00:00&timezone=UTCRun →ParameterTypeRequiredDescription
datetimestringNoISO-8601 datetime or now Default: nowtimezonestringNoIANA timezone Default: UTClatnumberNoOptional observer latitudelonnumberNoOptional observer longitudeSunrise, solar noon, sunset and day length for a Gregorian date and observer location.
/api/sunrise-sunset.php?date=2026-03-22&lat=25.396&lon=68.3578&timezone=Asia/KarachiRun →ParameterTypeRequiredDescription
datestringNoGregorian date YYYY-MM-DD or today Default: todaylatnumberNoObserver latitude Default: 25.396lonnumberNoObserver longitude Default: 68.3578timezonestringNoIANA timezone Default: Asia/KarachiApproximate vernal equinox instant for a Gregorian year.
/api/equinox.php?year=2026Run →ParameterTypeRequiredDescription
yearintegerNoGregorian year Default: 2026Approved Sindhi season label derived from apparent solar longitude.
/api/season.php?date=2026-07-11&timezone=Asia/KarachiRun →ParameterTypeRequiredDescription
datestringNoGregorian date YYYY-MM-DD or today Default: todaytimezonestringNoIANA timezone Default: Asia/KarachiLunar
Moon position, illumination, rise/set, validation and live geometry.
Geocentric lunar longitude, latitude, distance, right ascension and declination.
/api/lunar-position.php?datetime=2026-03-20T10:00:00&timezone=UTCRun →ParameterTypeRequiredDescription
datetimestringNoISO-8601 datetime or now Default: nowtimezonestringNoIANA timezone Default: UTCMoon age, elongation, illuminated fraction, percentage and phase label.
/api/moon-illumination.php?date=2026-07-11&timezone=Asia/KarachiRun →ParameterTypeRequiredDescription
datestringNoGregorian date YYYY-MM-DD or today Default: todaydatetimestringNoOptional ISO-8601 datetimetimezonestringNoIANA timezone Default: Asia/KarachiMoonrise and moonset times for a date, observer coordinates and timezone.
/api/moonrise-moonset.php?date=2026-07-11&lat=25.396&lon=68.3578&timezone=Asia/KarachiRun →ParameterTypeRequiredDescription
datestringNoGregorian date YYYY-MM-DD or today Default: todaylatnumberNoObserver latitude Default: 25.396lonnumberNoObserver longitude Default: 68.3578timezonestringNoIANA timezone Default: Asia/KarachiValidation report for calculated moon values and available reference data.
/api/moon-validation.php?date=2026-07-11&timezone=Asia/KarachiRun →ParameterTypeRequiredDescription
datestringNoGregorian date YYYY-MM-DD or today Default: todaytimezonestringNoIANA timezone Default: Asia/KarachiLive Earth–Moon observatory geometry using apparent coordinates and GMST subpoint calculations.
/api/earth-moon-live.php?datetime=now&timezone=Asia/KarachiRun →ParameterTypeRequiredDescription
datetimestringNoISO-8601 datetime or now Default: nowtimezonestringNoIANA timezone Default: Asia/KarachiCalendars & Time
Sindhu Sambat, Hijri, conversion, pahar, almanac and audit services.
Daily aggregate containing Sindhu date, solar, sunrise/sunset and lunar data.
/api/almanac.php?date=2026-07-11&lat=25.396&lon=68.3578&timezone=Asia/KarachiRun →ParameterTypeRequiredDescription
datestringNoGregorian date YYYY-MM-DD or today Default: todaylatnumberNoObserver latitude Default: 25.396lonnumberNoObserver longitude Default: 68.3578timezonestringNoIANA timezone Default: Asia/KarachiSindhu Sambat year, month and day for a Gregorian date.
/api/sindhu-date.php?date=2026-07-11Run →ParameterTypeRequiredDescription
datestringNoGregorian date YYYY-MM-DD or today Default: todaySindhu Sambat year using the working epoch and local vernal-equinox new-year rule.
/api/sindhu-year.php?date=2026-07-11Run →ParameterTypeRequiredDescription
datestringNoGregorian date YYYY-MM-DD or today Default: todayMonth-grid data around a selected Gregorian date for calendar interfaces.
/api/sindhu-month-grid.php?date=2026-07-11Run →ParameterTypeRequiredDescription
datestringNoGregorian date YYYY-MM-DD or today Default: todayGregorian ↔ Sindhu conversion and Sindhu month-length queries.
/api/converter.php?mode=gregorian&date=2026-07-11Run →ParameterTypeRequiredDescription
modestringNoConversion mode Default: gregoriandatestringNoGregorian date for gregorian modeyearintegerNoSindhu year for sindhu/month_days modesmonthstringNoSindhu month name or indexdayintegerNoSindhu day for sindhu modePakistan Hijri date from the month-start registry with observer timezone and sunset-boundary support.
/api/hijri-date.php?date=2026-07-11&lat=25.396&lon=68.3578&timezone=Asia/KarachiRun →ParameterTypeRequiredDescription
datestringNoGregorian date YYYY-MM-DD or today Default: todaydatetimestringNoOptional ISO-8601 datetimelatnumberNoObserver latitude Default: 25.396lonnumberNoObserver longitude Default: 68.3578timezonestringNoIANA timezone Default: Asia/KarachibufferintegerNoConfigured day adjustment bufferTraditional Sindhi pahar segment for a date, time and observer location.
/api/pahar.php?date=2026-07-11&lat=25.396&lon=68.3578&timezone=Asia/KarachiRun →ParameterTypeRequiredDescription
datestringNoGregorian date YYYY-MM-DD or today Default: todaylatnumberNoObserver latitude Default: 25.396lonnumberNoObserver longitude Default: 68.3578timezonestringNoIANA timezone Default: Asia/KarachiEquinox mapping, month-boundary continuity, reference-date and annual calendar audit.
/api/audit.php?year=2026Run →ParameterTypeRequiredDescription
yearintegerNoGregorian year Default: 2026Sky & Observation
Observer sky, planets, simulation, geodata and AR-ready catalogues.
Observer-based altitude and azimuth from right ascension, declination and local sidereal time.
/api/observer-sky.php?datetime=now&lat=25.396&lon=68.3578&timezone=Asia/KarachiRun →ParameterTypeRequiredDescription
datetimestringNoISO-8601 datetime or now Default: nowlatnumberNoObserver latitude Default: 25.396lonnumberNoObserver longitude Default: 68.3578timezonestringNoIANA timezone Default: Asia/KarachiSolar-system positions and visibility-oriented data for a selected date.
/api/solar-system.php?date=2026-07-11&timezone=Asia/KarachiRun →ParameterTypeRequiredDescription
datestringNoGregorian date YYYY-MM-DD or today Default: todaytimezonestringNoIANA timezone Default: Asia/KarachiSun, moon, illumination and eclipse archive data for date-wise visual simulations.
/api/simulation.php?date=2026-07-11&timezone=Asia/KarachiRun →ParameterTypeRequiredDescription
datestringNoGregorian date YYYY-MM-DD or today Default: todaytimezonestringNoIANA timezone Default: Asia/KarachiDeduplicated Sindh location directory and duplicate-name report.
/api/locations.php?mode=uniqueRun →ParameterTypeRequiredDescription
modestringNoDirectory mode Default: uniqueSearchable Sindhi/English object and constellation catalogue for sky and AR clients.
/api/sky/objects.phpRun →No query parameters.
Live sky payload and camera guidance for Android augmented-reality clients.
/api/sky/ar.php?lat=25.396&lon=68.3578&q=Moon&heading=120&pitch=25Run →ParameterTypeRequiredDescription
datetimestringNoISO-8601 datetime or now Default: nowtimezonestringNoIANA timezone Default: Asia/KarachilatnumberNoObserver latitude Default: 25.396lonnumberNoObserver longitude Default: 68.3578elevnumberNoElevation above sea level in metres Default: 0qstringNoSindhi or English object nameheadingnumberNoCamera compass azimuthpitchnumberNoCamera altitude anglehfovnumberNoHorizontal field of view Default: 60vfovnumberNoVertical field of view Default: 45include_below_horizonbooleanNoInclude objects below the horizon Default: trueinclude_outer_planetsbooleanNoInclude outer planets Default: trueEclipses
Archive and location-aware eclipse visibility services.
Solar and lunar eclipse archive with first-pass location-aware visibility summaries.
/api/eclipses.php?year=2026&type=all&lat=25.396&lon=68.3578&place=HyderabadRun →ParameterTypeRequiredDescription
yearintegerNoArchive year Default: 2026datestringNoOptional exact date YYYY-MM-DD or todaytypestringNoEclipse type Default: alllatnumberNoObserver latitude Default: 25.396lonnumberNoObserver longitude Default: 68.3578placestringNoPlace label Default: HyderabadOne eclipse event with a coarse local visibility summary for supplied coordinates.
/api/eclipse-visibility.php?id=l-2026-03-03&lat=25.396&lon=68.3578&place=HyderabadRun →ParameterTypeRequiredDescription
idstringYesEclipse event identifierlatnumberNoObserver latitude Default: 25.396lonnumberNoObserver longitude Default: 68.3578placestringNoPlace label Default: HyderabadValidation & Reference
Reference datasets, comparisons and multi-year validation reports.
Multi-year validation framework report for astronomical and calendar engines.
/api/validation.php?year=2026&years=5Run →ParameterTypeRequiredDescription
yearintegerNoStarting Gregorian year Default: 2026yearsintegerNoNumber of years Default: 5Availability and state of offline JSON reference datasets used for scientific comparison.
/api/reference-data.phpRun →No query parameters.
Compares populated reference values with current solar, lunar and equinox calculations.
/api/reference-comparison.phpRun →No query parameters.
Language & Terminology
Sindhi astronomical glossary and machine-readable knowledge fields.
Versioned Sindhi astronomical terminology API with search, taxonomy, semantic relations and AI/AEO fields.
/api/glossary.php?q=moon&limit=10Run →ParameterTypeRequiredDescription
actionstringNoOperation Default: listqstringNoSearch queryslugstringNoExact term slugcategorystringNoCategory filterstatusstringNoReview status filterapproved_onlybooleanNoReturn approved terms only Default: falselimitintegerNoMaximum records Default: 25offsetintegerNoPagination offset Default: 0fullbooleanNoInclude full term and schema fields Default: falseNo endpoints match this search.