Reports V2 API

Generate detailed, fully branded PDF and HTML astrology reports. Reports are generated asynchronously — you receive URLs immediately and the report is ready within 10-30 seconds.

Base URL

https://pdf.divineapi.com

Authentication

Every request requires two headers:

Live mode deducts from remaining_credits. Test mode deducts from remaining_test_credits.

Generate Report

POST /api/v1/reports/generate

How It Works

1. Send a POST request with birth data + branding — receive reportId + URLs immediately (status: processing)
2. Report generates in the background (10-30 seconds)
3. Poll GET /api/v1/reports/:reportId/status until status is completed
4. HTML and PDF URLs are ready to view/download

Request Headers

Content-Type: application/json
Authorization: Bearer {api_acc_token}
x-api-key: {api_key}

Request Body Parameters

Birth Data (Required)

Numerology reports use fname, lname, and mobile_number instead of full_name, hour, min, sec, gender, place, lat, lon, tzone.

Company Branding (Required)

Design Customization (Optional)

Example Request

curl -X POST https://pdf.divineapi.com/api/v1/reports/generate \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {api_acc_token}" \
  -H "x-api-key: {api_key}" \
  -d '{
    "report_type": "vedic-career-report",
    "full_name": "Rahul Sharma",
    "day": 15,
    "month": 6,
    "year": 1990,
    "hour": 14,
    "min": 30,
    "sec": 0,
    "gender": "male",
    "place": "New Delhi, India",
    "lat": 28.6139,
    "lon": 77.2090,
    "tzone": 5.5,
    "lan": "en",
    "company_name": "Astro Insights",
    "company_url": "https://astroinsights.com",
    "company_email": "info@astroinsights.com",
    "company_mobile": "+91 9876543210",
    "company_bio": "Your trusted source for Vedic astrology insights and guidance.",
    "footer_text": "© 2026 Astro Insights. All rights reserved.",
    "logo_url": "https://astroinsights.com/logo.png",
    "front_image": "https://astroinsights.com/cover.png",
    "report_name": "Career Astrology Report",
    "theme_color": "#ebab3d",
    "heading_color": "#800000",
    "text_primary_color": "#000000",
    "text_secondary_color": "#7b1300",
    "background_color": "#ffffff",
    "font_pairing": "elegant"
  }'

Success Response

{
  "reportId": "f8624bc3-71d8-4e72-bd95-895a9778fbd1",
  "htmlUrl": "https://pdf.divineapi.com/reports/html/84cd6e30.html?token=6adf39ad...",
  "pdfUrl": "https://pdf.divineapi.com/reports/pdfs/84cd6e30.pdf?token=df2746fe...",
  "statusUrl": "https://pdf.divineapi.com/api/v1/reports/f8624bc3-.../status?token=a1b2c3d4...",
  "status": "processing"
}

Error Responses

Missing Branding Fields (422)

If any required branding fields are missing:

{
  "error": "Missing required branding fields",
  "details": [
    "Please enter company name",
    "Please enter company url",
    "Please enter company email",
    "Please enter company mobile number",
    "Please enter company bio",
    "Please enter footer text",
    "Please enter logo url"
  ]
}

Invalid Color Format (400)

{
  "error": "Invalid color format for theme_color. Must be hex (#RRGGBB)."
}

Authentication Failed (401)

{
  "error": "Bearer token required"
}

{
  "error": "x-api-key header required"
}

{
  "error": "API key does not match authenticated user"
}

Insufficient Credits (402)

{
  "error": "Insufficient credits"
}

Rate Limit Exceeded (429)

{
  "error": "Rate limit exceeded. Maximum 100 reports per hour."
}

Check Report Status

GET /api/v1/reports/:reportId/status?token={token}

Poll this endpoint to check when a report is ready. The statusUrl is returned by the generate endpoint — use it directly.

Response

{
  "reportId": "f8624bc3-71d8-4e72-bd95-895a9778fbd1",
  "status": "completed",
  "htmlUrl": "https://pdf.divineapi.com/reports/html/84cd6e30.html?token=6adf39ad...",
  "pdfUrl": "https://pdf.divineapi.com/reports/pdfs/84cd6e30.pdf?token=df2746fe..."
}

Available Reports

Vedic Astrology Reports

Numerology Reports

Numerology reports require fname, lname, and mobile_number instead of the standard birth data fields.

Font Pairings

Rate Limits

Complete Flow Example

Step 1: Generate Report

curl -X POST https://pdf.divineapi.com/api/v1/reports/generate \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {api_acc_token}" \
  -H "x-api-key: {api_key}" \
  -d '{
    "report_type": "vedic-life-report",
    "full_name": "Priya Singh",
    "day": 22,
    "month": 3,
    "year": 1995,
    "hour": 8,
    "min": 15,
    "sec": 0,
    "gender": "female",
    "place": "Mumbai, India",
    "lat": 19.0760,
    "lon": 72.8777,
    "tzone": 5.5,
    "lan": "en",
    "company_name": "Astro Insights",
    "company_url": "https://astroinsights.com",
    "company_email": "info@astroinsights.com",
    "company_mobile": "+91 9876543210",
    "company_bio": "Your trusted source for Vedic astrology.",
    "footer_text": "© 2026 Astro Insights",
    "logo_url": "https://astroinsights.com/logo.png"
  }'

Response

{
  "reportId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "htmlUrl": "https://pdf.divineapi.com/reports/html/xyz.html?token=abc123...",
  "pdfUrl": "https://pdf.divineapi.com/reports/pdfs/xyz.pdf?token=def456...",
  "statusUrl": "https://pdf.divineapi.com/api/v1/reports/f8624bc3-.../status?token=a1b2c3d4...",
  "status": "processing"
}

Step 2: Poll Status (wait for completion)

curl https://pdf.divineapi.com/api/v1/reports/a1b2c3d4-e5f6-7890-abcd-ef1234567890/status?token=abc123...

Response (while generating)

{
  "reportId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "statusUrl": "https://pdf.divineapi.com/api/v1/reports/f8624bc3-.../status?token=a1b2c3d4...",
  "status": "processing"
}

Response (when ready)

{
  "reportId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "completed",
  "htmlUrl": "https://pdf.divineapi.com/reports/html/xyz.html?token=abc123...",
  "pdfUrl": "https://pdf.divineapi.com/reports/pdfs/xyz.pdf?token=def456..."
}

Step 3: Download or Display

• Open htmlUrl in a browser to view the interactive HTML report
• Open pdfUrl to download or embed the PDF report