Share a report via email

Generate a PDF for a completed report, email it to the authenticated user, and return a shareable link key.

Request: Bearer token

Body: report_type (kundali / palm / tarot / marriage / child), report_reference_key (e.g. Kundali-12345, Palm-2322, Baby-12345)

Success: 200 - data contains share_key (Share-XXXXX), pdf_url (direct R2 link), report_type. Also returns 200 with success: false and code: PLAN_LIMIT (not an HTTP error) when header X-Enforce-Paywall: true is sent and this report was never purchased. Two exemptions never hit this gate, paywall or not: kundali (plan-included, never one-time-purchased) and tarot's daily single-card reading (a free feature - only tarot's 3-card spread is gated within report_type=tarot; distinguished internally by the reading's own reading_type, not by anything the caller passes)

Errors: 401 - invalid token | 404 - report not found or not ready | 422 - invalid report_type

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Example

{
    "report_reference_key": "Kundali-12345",
    "report_type": "kundali"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Successful Response

Bodyapplication/json

Example

{
    "success": true,
    "message": "Success",
    "data": {
        "share_key": "Share-12345",
        "pdf_url": "https://cdn.hastaai.in/reports/kundali/uuid.pdf",
        "report_type": "kundali"
    }
}

🟠401Unauthorized

🟠404Record Not Found

🟠422Parameter Error