---
title: "Subscription Digest Endpoint"
method: POST
path: "/alerts/digest"
---

# Subscription Digest Endpoint

`POST /alerts/digest`

## Request

- Base URL: `https://jyotish-api.bda.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://jyotish-api.bda.ai/alerts/digest`
- Auth: none declared

Unified subscription DIGEST — the COMPUTE half of subscription
delivery/alerts. Composes the member's three alert feeds — dasha changes
(/alerts/dasha), slow-graha transit changes (/alerts/gochar) and festivals/vrats
(/alerts/festival) — into ONE chronological "what's coming up for you" feed over a
shared look-ahead window. Pure composition over the three already-computed feeds:
every entry is a verbatim sub-feed event with a factual bilingual headline; no new
astrological computation, no fabrication. This is the content layer a member's
subscription would deliver — the scheduled DELIVERY itself (a worker + prod-config)
is a separate infrastructure layer that is NOT performed here and is disclosed in
the digest's `delivery_note`. §12 guidance-not-fatalism; no scripture quoted.

## Request body

- SubscriptionDigestRequest
  - `name` string, nullable
  - `gender` string, nullable
  - `date_of_birth` string, date, required
  - `time_of_birth` string, required: HH:MM:SS in local time
  - `time_accuracy` string: exact|approximate|unknown
  - `lat` number, required
  - `lng` number, required
  - `tz` string, nullable
  - `window_days` integer: Shared look-ahead window in days applied to all three feeds (dasha changes, slow-graha transit changes, festivals/vrats)

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/bda/apis/bda-jyotish-panchang-service.md) · [All operations](https://skmtc.dev/bda/apis/bda-jyotish-panchang-service/llms.txt) · [OpenAPI document](https://skmtc.dev/bda/apis/bda-jyotish-panchang-service/revisions/90f241bf4009?raw)