Demo MYGA Endpoint

POST /api/pdf/DemoMYGA

Generate a PDF illustration for Multi-Year Guaranteed Annuity (MYGA) products.

Endpoint

POST https://api.illustrata.com/api/pdf/DemoMYGA

Authentication

This endpoint requires Bearer token authentication. See Authentication for details.

Request Headers

Header	Required	Description
Authorization	Yes	Bearer token (format: Bearer ill_xxx...)
Content-Type	Yes	Must be application/json

Request Body

{
  "printIllustration": "yes",
  "annuiyInputData": {
    "Product": "Demo MYGA",
    "initamt": 100000,
    "State": "CA"
  }
}

Field Descriptions

Top Level Fields

Field	Type	Required	Description
printIllustration	string	Yes	"yes" for PDF output, "no" for JSON data
annuiyInputData	object	Yes	Annuity configuration data

Annuity Input Data Fields

The annuiyInputData object accepts flexible fields that vary by product configuration. Common fields include:

Field	Type	Description	Example
Product	string	Product name	"Demo MYGA"
initamt	number	Initial investment amount	100000
State	string	US state code	"CA", "NY", "TX"

Additional fields may be included based on your specific product requirements. The API accepts any valid JSON structure within annuiyInputData.

Response

Success Response (200 OK)

When printIllustration: "no"

Returns JSON data with illustration details.

When printIllustration: "yes"

Returns a PDF file with headers:

• Content-Type: application/pdf
• Content-Disposition: inline; filename=illustration_[timestamp].pdf

Error Responses

Validation Error (400)

{
  "error": "Validation error",
  "message": "printIllustration must be 'yes' or 'no'"
}

Authentication Error (401)

{
  "error": "Invalid or inactive API key",
  "message": "API key not found or expired"
}

Rate Limit Error (429)

{
  "error": "Rate limit exceeded",
  "message": "Too many requests. Please try again later."
}

Example Requests

cURL

curl -X POST https://api.illustrata.com/api/pdf/DemoMYGA \
  -H "Authorization: Bearer ill_your_api_key_here" \
  -H "Content-Type: application/json" \
  -o illustration.pdf \
  -d '{
    "printIllustration": "yes",
    "annuiyInputData": {
      "Product": "Demo MYGA",
      "initamt": 100000,
      "State": "CA"
    }
  }'

JavaScript (Fetch)

const response = await fetch("https://api.illustrata.com/api/pdf/DemoMYGA", {
  method: "POST",
  headers: {
    Authorization: "Bearer ill_your_api_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    printIllustration: "yes",
    annuiyInputData: {
      Product: "Demo MYGA",
      initamt: 100000,
      State: "CA",
    },
  }),
});

if (response.ok) {
  const blob = await response.blob();
  // Handle PDF blob
}

Notes

• The printIllustration field must be exactly "yes" or "no"
• State codes must be valid US state abbreviations
• The annuiyInputData structure is flexible and depends on your product configuration
• Rate limiting: 100 requests per 15-minute window by default