---
title: "Published reference charts"
method: GET
path: "/v1/astro/reference-charts"
tags: ["Vedic Reference"]
---

# Published reference charts

`GET /v1/astro/reference-charts`

## Request

- Base URL: `https://api.asterwise.com`
- URL: `https://api.asterwise.com/v1/astro/reference-charts`
- Auth: HTTP bearer

Test charts with reference values from an independent source, so anyone can check the maths. The 25 edge cases of the verification harness (clock changes, southern hemisphere, polar night and day, the date line, 45-minute zones, historical offsets, leap day, the range limits) and a sample of random charts, each with the sidereal longitudes, signs, nakshatras and ascendant from PyJHora (a port of Jagannatha Hora), plus a Moon-on-a-nakshatra-boundary case from a direct Swiss Ephemeris call and an unknown-birth-time behaviour case. Send each input to /v1/astro/natal and compare.

## Response `200`

Successful Response

- ApiResponseReferenceChartsResponse
  - `success` boolean: True if the request succeeded
  - `message` string: Human-readable status message
  - `data` ReferenceChartsResponse, required
    - `version` integer, required
    - `how_to_use` string, required
    - `harness` string, required
    - `charts` ReferenceChart[], required
      - `id` string, required
      - `covers` string, required: The hard case this chart exercises.
      - `input` object, required: The exact request body for /v1/astro/natal (time null = unknown birth time).
      - `expected` object, required: Reference values: UTC instant, local time status, true ayanamsa, planets (sidereal longitude, sign, nakshatra, pada, retrograde) and ascendant.
      - `reference_source` string, required: Where the expected values come from. Never Asterwise.
      - `tolerance` object, nullable: How close a correct engine must come.

## Other responses

- `401`: Authentication failed
- `403`: Authorization failed
- `404`: Resource not found
- `413`: Payload too large
- `422`: Validation error
- `429`: Rate limit exceeded
- `500`: Internal error
- `502`: Upstream provider error
- `503`: Service unavailable

---

[API](https://skmtc.dev/asterwise/apis/asterwise-api.md) · [All operations](https://skmtc.dev/asterwise/apis/asterwise-api/llms.txt) · [OpenAPI document](https://skmtc.dev/asterwise/apis/asterwise-api/revisions/3c4bbb1194e2?raw)