Demo FIA Endpoint

POST /api/pdf/DemoFIA

Generate a PDF illustration for Fixed Index Annuity (FIA) products.

Endpoint

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

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 FIA",
    "initamt": 50000,
    "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 FIA"
initamt	number	Initial investment amount	50000
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/DemoFIA \
  -H "Authorization: Bearer ill_your_api_key_here" \
  -H "Content-Type: application/json" \
  -o illustration.pdf \
  -d '{
    "printIllustration": "yes",
    "annuiyInputData": {
      "Product": "Demo FIA",
      "initamt": 50000,
      "State": "CA"
    }
  }'

JavaScript (Fetch)

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

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

Key Differences from MYGA

Feature	FIA	MYGA
Product Type	Index-linked returns	Fixed guaranteed rate
Interest Method	Variable based on index	Fixed rate
Complexity	More complex illustrations	Simpler illustrations

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
• FIA illustrations may take slightly longer to generate due to index calculations