---
title: "Api V1 Donation State"
method: POST
path: "/api_v1_donation_state"
---

# Api V1 Donation State

`POST /api_v1_donation_state`

## 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/api_v1_donation_state`
- Auth: none declared

Return the canonical donation state for the dashboard's
`donation_seva` widget.

Inputs:
  state   — the client's localStorage envelope (DonationPromptState).

Outputs:
  total_given_aud, currency, last_at, donor (bool), prompt_eligible,
  and bilingual CTA label.

No DB write — donation persistence migration is tracked as a
separate block. The widget passes its state up, server returns a
normalised + decorated view.

## Request body

- DonationStateRequest
  - `session_id` string, nullable
  - `member_id` string, nullable
  - `email` string, nullable
  - `state` object, nullable

## 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)